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Preface 


This manual is one of a series designed to instruct and guide the programmer in the use 
of the SPERRY UNIVAC Operating System/3 (OS/3). It specifically describes screen 
format services (SFS), the interactive component of OS/3 that provides an easy and 
effective method for inputting and outputting data. 


The intended audience is the programmer with a basic knowledge of data processing, 
but with little programming experience. 


This manual is divided as follows: 
m Section 1. Introduction 
- Introduces you to screen formats as an input and output facility for programs. 
- Describes the capabilities that SFS provides, via the screen format generator 
(SFG) and the screen format coordinator (SFC), for creating and using screen 
formats. 


m Section 2. Type Attributes and Editing Rules 


Discusses a variation of COBOL editing rules to be observed when creating your 
own formats. 


m Section 3. Using the Screen Format Generator (SFG) 
- Explains how to initiate the SFG session. 
- Describes the home screen. 
~ Discusses the use of the HELP function. 


- Describes the characteristics screen and the results produced by making 
various specifications on it. 


- Explains the various dialog and optional screens. 
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m Section 4. Creating Screen Formats 





Provides detailed instructions for creating your own screen formats. 
m Section 5. Modifying Formats 
Explains various methods for changing existing formats. 
m Section 6. Additional Functions 
Describes the functions that enable you to display and print existing formats and 
format information. Explains the functions that delete formats and terminate the 


SFG session. 


m Section 7. Associating Formats with a Program: Using the Screen Format 
Coordinator (SFC) 


- Explains how screen formats become functional with a program through the 
SFC. 


- Discusses job control requirements. 


- Introduces programming requirements related to RPG Il, COBOL, FORTRAN IV, 
assembler language, ESCORT, and IMS interfaces. 





m= Appendix A. Job Control Considerations 
Provides more information about the USE SFS job control statement. Describes the 
job control language statements necessary to use more than one workstation 
(applicable to RPG Il programmers only). 
m= Appendix B. Help Screens 
Shows the various help screens you can request during creation of a screen format. 
m Appendix C. Function Keys 


Describes the various function keys you can use with screen format services. 


The following publications are referenced in this manual and are either useful or 
necessary to the programmer working with screen format services. 


System 80 


m= Consolidated data management macro language user guide/programmer reference, 
UP-8826 


m= Assembler user guide, UP-8913 





= FORTRAN IV programmer reference, UP-8814 
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Interactive services commands and _ facilities user guide/programmer reference, 
UP-8845 


RPG Il user guide, UP-8067 
1974 ANSI COBOL programmer reference, UP-8613 
Job control user guide, UP-8065 


General editor user guide/programmer reference, UP-8828 


Series 90 Systems 


Assembler user guide, UP-806 1 
FORTRAN IV programmer reference, UP-8474 


Interactive services commands and facilities user guide/programmer reference, 
UP-8845 


RPG Il user guide, UP-8067 
1974 ANSI COBOL programmer reference, UP-8613 
Job control user guide, UP-8065 


General editor user guide/programmer reference, UP-8828 
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1. Introduction 


1.1. PROVIDING INFORMATION VIA FORMS 


One of the most common methods of providing and receiving information is through the 
use of forms. Whether we are filling them out, sending them in, or receiving them, 
almost every facet of activity, from recreation to business, involves the use of forms at 
some point. Applying for loans, credit cards, a driver’s license; subscribing to 
magazines; preparing tax returns; even writing a check: doing any of these things 
necessitates handling a form. 


Naturally, we take forms for granted and are even annoyed with the frequency at which 
we are required to handle them. We realize, however, that they provide one of the 
easiest and most effective ways for information to be supplied as well as received. 
They ensure a certain amount of uniformity that is essential whenever a transfer of 
information from one point to another is required. 


How does this concern you? Well, since forms are capable of eliminating wasted time 
and confusion in other environments by standardizing the flow of information, they can 
provide a similar service in the data processing environment too: specifically by taking 
the complexity out of input and output methods. For this purpose, Sperry Univac has 
designed screen formatting facilities. 

1.2. PROVIDING INFORMATION VIA SCREEN FORMAT SERVICES 

Screen format services is an interactive component of OS/3 that enables you to create 
formats (forms), not on paper, but on a video terminal - your workstation. Additionally, 
it provides you with the capabilities for easily maintaining these formats. 

Once created, a format can be used: 

m §=«To input all the necessary data to a program 


= To display output data from a program 


w To supply input and display output 
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Inputting and outputting data via a screen format is extremely fast and simple. It is 
done on a fill-in-the-blanks basis. Practically anyone can input data to a program in this 
manner merely by keying in the information that the format requests. For output, the 
blanks of a screen format are automatically filled in with the proper information. Such % 
output is easier to read as well as to interpret because it is formatted. 





Figure 1-1 is an example of a screen format used for input purposes. 


VOTER'S REGISTRATION 


a. The format requests information. 





VOTER'S REGISTRATION 
NAME: JOHN DOE 
ADDRESS:2153 MAIN ST. PHILA., PA. 
VOTING DISTRICT:WARD 1 
SERIAL NO:944310 PARTY:DEM 
DATE OF ISSUE:AUGUST, 23 1978 
REGISTRAR:MARY SMITH 


The corresponding information is filled in at the 
workstation and is automatically transferred to 
the program as input. 


VOTER'S REGISTRATION 


After the program accepts the information as 
input data, the format can be used again. 





Figure 1-1. Screen Format Used to Supply input Data 
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Figure 1-2 illustrates a screen format used for output purposes. 


ACCOUNT STATUS REPORT 
ACCOUNT NO: 1827841 DATE:01/03/82 


CREDIT:375.00 
DEFICIT:250.00 BALANCE: 125.00 


a. The screen format displays output. 


ACCOUNT STATUS REPORT 
ACCOUNT NO: 1922640 DATE:01/03/82 
CREDIT:250.00 


DEFICIT: 100.00 BALANCE: 150.00 


b. The format can be used to display output of this type as long as necessary. 


Figure 1-2. Screen Format Used to Display Output Data 





1-3 





Figure 1-3 illustrates how a screen format can serve both input and output purposes. 


a. 


PERSONAL CREDIT REPORT 
NAME: JOHN DOE 
ADDR:1552 MAIN ST. STATE=:PA ZIP:19140 
ACCOUNT NO: 193-A564 
BALANCE:350.00 
PAYMENT: 


The format displays information for a particular customer and requests information as well. 


PERSONAL CREDIT REPORT 
NAME: JOHN DOE 
ADDR:224 PINE ST. STATE:PA ZIP:19102 
ACCOUNT NO:193-A564 
BALANCE:350.00 
PAYMENT :25.00 DATE: 12/23/82 


The workstation operator changes the customer's address and makes the appropriate 
entries for PAYMENT and DATE. Information on the format is passed to the program. 


Figure 1-3. Screen Format Used for Input and Output (Part 1 of 2) 
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PERSONAL CREDIT REPORT 
NAME:MARY SMITH 
ADDR:1204 MASON AVE. STATE:PA ZIP: 19054 
ACCOUNT NO: 193-B643 
BALANCE: 225.00 
PAYMENT: 


c. The format for another customer is then displayed at the workstation. 





Figure 1-3. Screen Format Used for Input and Output (Part 2 of 2) 


You create and use screen formats through the two software elements that make up 
screen format services: the screen format generator and the screen format coordinator. 


The screen format generator (SFG) is the software element that allows you to generate 
screen formats at the workstation. During generation, you specify the layout of each 
format as well as other characteristics that best enable the format to meet the input 
and output requirements of a particular program. The SFG automatically stores the 
completed formats (as an FC-type module) for you either on a system library (SYSFMT) 
that resides on the SYSRES volume or on a MIRAM user library that you specify when 
you create the formats. The SFG makes these formats readily available for you to 
modify, delete, or simply look at whenever necessary. 


The screen format coordinator (SFC) becomes active when you actually want to use an 
existing format with a program. 


The SFC automatically gets the format you request and displays it on the workstation 
screen so that filling in the blanks can begin. The SFC is, as its name implies, 
responsible for coordinating the transfer of input and output data between your program 
and the format that’s displayed on the workstation screen. 
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Figure 1-4 illustrates how the SFG and SFC process your formats. 


SCREEN 
FORMAT 
GENERATOR 
(SFG) 


(a) Interaction 


between you and the 
SFG to create, modify, 
delete, or display a 
format. 


SCREEN 
FORMAT 


COORDINATOR 


(SFC) 


FORMATS 
ON 
SYSFMT 
OR 
USER 
LIBRARY 


Formats 


are automatically 

stored on a library 

file. The SFG can display 
any format 

that you wish to 

modify, delete, or 

simply look at. 


APPLICATION 
PROGRAM 


The SFC retrieves the requested format The SFC can pass output data from the program 
and displays it on the workstation. A and display it on the requested format at the 
workstation operator fills in the blanks of the workstation. 
format. The SFC passes this information to the 
program. 





Figure 1-4. The Function of the SFG and SFC 
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Together, the SFG and the SFC provide you with everything you need to create, 
maintain, and ultimately use screen formats. 





NOTE: 
To be used successfully for screen format services, remote communications terminals 


(the UTS 200 or UTS 400) must have the field protect feature. If this feature is not 
provided, an error message (SF 16) will occur whenever the operator enters data. 


1.3. SCREEN FORMAT GENERATOR 


1.3.1. Functions of the SFG 


Let's concentrate on the functions of the SFG: 


SCREEN FORMATS 
FORMAT 
GENERATOR 
(SFG) 





LIBRARY 


(a) Interaction Formats 


between you and the are automatically 
SFG to create, modify, stored on a library 
delete, or display a file. The SFG can disptay 
format. any format 

that you wish to 

modify, delete, or 

simply look at. 
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The SFG lets you create a format, modify (change) a format, display a format, and 
delete a format. With the ease of use characteristic of the SFG, practically anyone can 
perform these tasks - there’s no need to be an experienced computer programmer. 


You begin a format’s creation (generation), for example, by answering a series of 
questions, collectively called the home screen, that are displayed at the workstation 
(see 3.2). You then key in the layout for the desired format. An example of such a 
layout is: 


PERSONAL CREDIT REPORT TYPE:_ DATE:__/__/ 


PAST DUE AMOUNT: 
NEW BALANCE: 
MINIMUM PAYMENT: 





There are several steps, or passes, in which you can provide more specific information 
about the format, including whether it will be used for input, output, or both. These 
passes (explained in Section 4) are easy to complete and are generally the same for 
every format, so that after you've created one format, subsequent creations and 
modifications become almost second nature. 


Other SFG functions are even simpler to complete. Before changing a format, for 
example, you might want to examine it to decide exactly what changes need to be 
made. In such cases, the SFG can automatically provide you with a display of any 
format stored on the library file. You need only supply the format’s name. The format’s 
name is likewise the criterion for deleting any format from the library. You supply the 
name, and the SFG does the work. 


The SFG has additional features to make any of the format-related functions, particularly 
creation and modification, even easier to complete. 


| Error Indication 


The SFG automatically notifies you of a variety of mistakes as soon as they are 
made. In most cases, the error is blinked on the workstation screen. In some 
instances, a specific error message is displayed. Thus, you are made aware of and 
can correct certain errors as soon as they occur. 


| Prompting 


If you’re not quite sure how to begin creating or modifying a format or if you're 
having difficulty along the way, you can ask the SFG for help simply by pressing a 
particular workstation function key (F13). The SFG then displays the instructions 
necessary to complete the operation causing the difficulty. You can be prompted in 
this fashion through as much or as little of any function (creating a format, 
modifying a format, etc) as necessary. 
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1.3.2. Screen Format Components 


You now know that the SFG enables you to create, modify, delete, or display a format 
with a minimum of difficulty. Before we begin a more detailed discussion of these 
functions, however, you should know a little more about the nature of the format itself. 


Formats can vary in size and complexity, as shown in the following screens. 


SALES REPORT 
PRODUCT: 


CLASS RANK 


GRADE POINT AVERAGE: _ 
CLASS RANK: 





WAREHOUSE INVENTORY CONTROL 
PROD. 
STOCK 
MFR: 
QTY ON HAND: 


QTY DISCOUNT: __ % FOR QTYS OVER: 





No matter how simple or complex, a format consists of only two components: display 
constants and variable data fields. 
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1.3.2.1. Display Constants 


Display constants are portions of a screen format that never vary. For the most part, 
they serve as either headings or titles to introduce the information that will eventually fill 
in the blanks that follow. The shaded portions of the following format are display 
constants. 





Once a format is displayed on the workstation screen in the first step of its creation, 
you cannot alter display constants in any of the successive steps. To change a display 
constant, you must initiate one of the SFG functions for modifying the format after it's 
created. 


Likewise, when a format is being used to input data to or output data from a program, 
a display constant cannot accidentally be changed or blanked out either by the 
workstation operator or by any screen activity that results from the program. The 
program can never reference a display constant. 


Other characters on a format, such as the slashes (/) separating the month, day, and 
year in a date, are also display constants. As a general rule, any character, other than 
an underline, that you enter when you first lay out the format is considered a display 
constant. 


1.3.2.2. Variable Data Fields 


Those portions of a format that are used either to input data to or to output data from 
a program are variable data fields. When creating a format, you always indicate variable 
data fields by underlines, with the number of underlines representing the external length 
of the field. 


In successive steps during a format’s creation, you make specifications as to the type 
of variable data a field receives (numeric, alphabetic, etc). Once the format is laid out, 
the remainder of the creation process deals exclusively with specifying everything from 
general to detailed characteristics for each variable data field in the format. The field’s 
input and output directions are also specified, and since this (inputting and outputting) is 
the purpose behind generating formats in the first place, we'll discuss |/O directions 
briefly here. 
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Every variable data field must belong to one of three |/O classifications: input, output, 
or both input and output (bidirectional). 


m= Input 


Those fields designated during creation as input fields can only be used by the 
workstation operator to enter input data to a program at run time. 


= = Output 


Those fields designated during creation as output fields can only be used to display 
output data from the system at run time. 


= Both 


Those fields designated during creation as bidirectional can be used either to input 
data to the program or to display output data from the system at run time. 


The first time a format is displayed (when a program selects the format), input fields are 
(usually) represented with underlines. For example: 


Output fields, on the other hand, always display data. 
NAME: MARY SMITH 


An output field will never be displayed as 


unless the program supplies that field with underline characters. 


A bidirectional field is always expected to receive output the first time a format is 
displayed. In other words, it acts initially as an output field. 


NAME: MARY SMITH 
Depending on the program specifications, a bidirectional field can continue to display 
output, or it can accept input, or it can do both. In the preceding field (NAME), the 
workstation operator could, for example, change the last name simply by entering a 
new name over it. 


NAME: MARY JONES 


The program accepts the new name as input. 
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The format shown in Figure 1-1 (1.2) contains only input fields. The fields in Figure 1-2. 
could be either output fields displaying output or bidirectional fields displaying output. In 
Figure 1-3a, the fields NAME, STATE, ZIP, ACCOUNT NO, and BALANCE could be 
either output or bidirectional fields. You can be sure, however, that ADDR is a 
bidirectional field since the address is changed in Figure 1-3b. The fields PAYMENT and 
DATE are strictly input fields. 


The procedure for specifying !/O directions for variable data fields is discussed in 3.5.1. 


NOTE: 


Any reference to fields in the remainder of this manual refers to variable data fields 
only. 


1.3.2.3. Protected and Unprotected Parts — Low-Intensity Display 


As you'll recall from 1.3.2.1, once defined, display constants cannot be altered either 
while successive passes of the creation process are being performed or while the 
completed format is being used with a program. These and other parts of a screen 
format with similar characteristics can be described as protected. 


Depending on the particular part, there are differences in the extent to which it is 
protected. Also, in most cases the SFG automatically protects a part simply by virtue of 
its characteristics. In some cases, however, you can specify the protection yourself. 


m Display Constants 


Display constants are automatically protected as soon as you finish laying out the 
format. They remain so throughout the rest of the format’s creation and also 
throughout any subsequent use of the format with a program until the entire format 
display is erased. Display constants are therefore totally protected and can only be 
changed via one of the SFG’s modification functions. 


@ Output Fields 


As explained in 1.3.2.2, a field that is specified for output during a format’s 
creation is used exclusively to display variable data from the system. Displayed 
output data cannot be changed or erased by the workstation operator. Only new 
output coming from the system can overwrite previously displayed output. 
Naturally, output will be erased whenever the entire screen display is erased. It is in 
this sense that output fields are automatically protected. 


m Specific Characters Used for Editing Input or Bidirectional Fields 


At a certain point during creation of the format, you can specify editing for certain 
variable data fields by keying in COBOL-like picture clauses. If editing is specified 
for an input or bidirectional field, you have the option of specifying protection for 
certain characters in the picture string: the comma (,) and the decimal point (.). The 
SFG automatically protects a fixed currency symbol ($). These characters become a 
sort of edit mask and, because they are protected, cannot be altered by a 
workstation operator or by the activity of the system. 
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Although you should know what protection means, it isn’t necessary for you to 
memorize which parts of a screen format are protected since the SFG makes the 
distinction. Protected parts are displayed on the workstation in low intensity. 
Low-intensity display simply means that the protected parts (characters) appear less 
bright than those that are unprotected. 


NOTE: 


During the creation or modification functions, there are several forms displayed by the 
SFG (the home screen, for example) the answers to which provide certain information 
about the format. Although not physically related to the format layout, portions of these 
displays are also protected and are displayed in low intensity. 


1.4. SCREEN FORMAT COORDINATOR (SFC) 


As mentioned earlier, the SFC becomes active when you want to use an existing format 
with a particular program for the purpose of inputting and outputting. 


SCREEN 
FORMAT APPLICATION 
COORDINATOR PROGRAM 
(SFC) 


The SFC retrieves the requested format The SFC can pass output data from the program 
and displays it on the workstation. A and display it on the requested format at the 
workstation operator fills in the blanks of the workstation. 
format. The SFC passes this information to the 
program. 




















UP-8802 Rev. 2 SPERRY UNIVAC OS/3 1-13 
SCREEN FORMAT SERVICES 











The SFC is responsible for retrieving the format (F-type module in $Y$FMT or your user 
library) you requested and displaying it on the workstation screen. Since the format is 
completely separate from your program, the SFC must also coordinate the flow of data 
between the program and the format. 


In addition to transferring data back and forth, the SFC performs other necessary 
operations, such as checking or validating any input data that is filled in by the 
workstation operator. The data is checked against the specifications that you made for 
the field when you created or modified the format. 


As will be explained in Section 4, there is a specific pass, or step, in the format’s 
creation (for example, pass 2 - type attribute screen) where you indicate whether the 
field is to receive numeric, alphanumeric, or alphabetic data. If a field does not receive 
this type of data, the SFC will not accept the data as input to the program. Incorrect 
input is blinked on the workstation screen. 


Since the SFC performs these and similar operations automatically, there’s no need for 
you to be concerned with its activities at any time during the format’s use. Simply be 
aware that the SFC handles the format according to the specifications you made during 
creation or modification via the SFG. 


Although the SFC assumes the bulk of the responsibility for handling program input and 
output, you are responsible for such things as the proper job control statements 
associated with screen format services and for identifying as well as calling that format 
within the program. Specifics concerning job control statements and the necessary 
program statements as they relate to the particular language being used are discussed 
in Section 7. 
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2. Type Attributes and Editing Rules 


2.1. CONSIDERATIONS FOR VARIABLE DATA FIELDS 


As mentioned in 1.3.2.2, when you create a format, you specify variable data fields to 
handle the program’s input and output data. In a specific step during the format’s 
creation, you must define the type of data that each field is to receive. Data for variable 
fields can be in one of the following types: alphabetic, numeric, or alphanumeric. These 
are referred to as field type attributes. 


With the SFG, you have the option of specifying editing for numeric fields and, to some 
extent, for alphabetic and alphanumeric fields as well. Since editing can be specified 
during creation of the format, your program has only to indicate such things as 
assumed decimal places (v) and signs (s) whenever appropriate, but not edit masks. 


In Section 4, we'll discuss specifying type attributes and editing characters when 
creating a screen format. However, knowing the rules for type attributes and editing 
beforehand can be helpful. 


2.2. TYPE ATTRIBUTES 


The rules for indicating field types are similar to the rules applying to COBOL picture 
clause expressions: 


# Alphabetic Fields 


You use one or more A’s to indicate that a particular field will receive alphabetic 
data when the format is in use. However, duplication factors (as A(2) in COBOL to 
indicate an alphabetic field that is two characters in length) are not supported. 


A field defined as alphabetic can, at run time, contain any combination of the 26 
characters of the alphabet and the space. These characters will be left-justified with 
blank padding. 
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m Numeric Fields 


You use one or more Q's to indicate that a format field can receive numeric data. 
Duplication factors are not supported. A field defined as numeric can, at run time, 
contain any combination of the numeric characters O through 9. A field of this type 
will be right-justified with zero padding. 


a Alphanumeric Fields 


You can use any combination of X’s, A’s, or 9’s to represent an alphanumeric 
field. Duplication factors are not supported. The positions indicated by X’s can, at 
run time, contain any combination of EBCDIC characters. Positions indicated by 9’s 
or A’s can only contain the numbers O through 9 and alphabetic characters 
respectively. A field defined as alphanumeric will be left-justified with blank 
padding. 


2.3. EDITING 


Once you decide whether a field is to be alphabetic, alphanumeric, or numeric, your next 
consideration is whether you want to edit the field. Editing can be specified for any field 
in the format, although in some cases certain types of editing and edit characters 
restrict the field to handling output data only. 


2.3.1. Editing Alphabetic and Alphanumeric Fields 


You may use an exclamation point (!) to edit alphabetic and alphanumeric fields as 
shown in the following examples. 


AAA! AAA 
XX!XX!XX 
XX!99!AA 


This character reserves the position where it appears so that an insertion character that 
you select (such as a dash or a slash) can replace it. Positions indicated by the 
exclamation point are always protected and are never counted in the field's internal 
length. A field edited in this manner may be used for input, output, or both. 


You may use the characters O (zero) and B in an alphanumeric field as shown in the 
following examples. 


XXBXXOOXX 
SOBBXOAA 


These characters reserve the positions where the numeral O and the space will be 
automatically inserted at run time. An alphanumeric field using either of these two 
characters may not use the exclamation point and vice versa. Also, such a field may be 
used only to display output data. The O and the B are counted in the external but not 
the internal field length. 
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NOTE: 


External field length refers to the appearance of the field on the workstation screen, 
whereas internal length refers to the length of the field when referenced by the user 
program. 


2.3.2. Editing Numeric Fields 


You can edit a numeric field by using an exclamation point (!), insertion characters, or 
suppression. 


The exclamation point gives you the same capabilities for numeric fields as it does for 
alphabetic and alphanumeric fields. A numeric field using the exclamation point may not, 
however, use any other form of editing and vice versa. Other SFG editing rules are 
similar in most aspects to COBOL editing rules. 


The valid characters you can use for insertion or suppression editing are: asterisk (*), Z, 
plus sign (+), minus sign (-), CR, DB, decimal point (.), comma (,), blank (B), zero (0), 
and currency sign ($). 


m Insertion Editing 


There are three types of insertion editing that you can specify during format 
generation: simple, fixed, and floating. 


- Simple Insertion 


You may insert the comma (,), the blank (B), and zero (O) into any numeric field 
as shown in the following examples. 


9,999 
98B99900 


The comma may be used in an input, output, or bidirectional field. Fields using 
the B or O are always output fields. 


- Fixed Insertion 
You may insert the currency sign ($), plus sign (+), minus sign (-), credit 
symbol (CR), debit symbol (DB), comma (,), and decimal point (.) into any 
numeric field as shown in the following examples. 
$9,999.99 
+999 
9,999.99CR 


Fields using CR or DB are always output fields. 
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- Floating Insertion 


You may express the currency sign ($), plus sign (+), and minus sign (-) as 
floating signs as shown in the following examples. 


$$$9.99 
#999 


The sign represents the leftmost position (before the first significant digit) into 
which it ($, +, or -) will be inserted. A field edited in this manner may only be 
used for output. 


m Suppression/Replacement Editing 
You may do this type of editing in one of two ways: 


- The character Z represents the suppression of leading O's (up to the first 
significant digit) and their replacement with blanks as shown in the following 
examples. 


22,229 
$2,229.99 


- The asterisk (*) represents the suppression of leading O’s (up to the first 
significant digit) and their replacement with the * (e.g.,** 9.99). 


A field edited either way may only be used for output. 


Refer to the 1974 ANSI COBOL programmer reference for more information concerning 
insertion and suppression/replacement editing for numeric fields. 


2.4. RESULTS OF EDITING FORMAT FIELDS 


You define type attributes and editing for variable data fields in pass 2 of the format’s 
generation (see 4.1.2). In a later step (dialog screen 1, 3.5.1), you specify the 
characters to replace any exclamation points in a field, and optionally you can specify 
protection for certain characters in edited numeric fields (that are input or bidirectional), 
thus creating an edit mask. 


Editing affects the display of a field when the format is presented at the workstation 
and consequently the way in which data can be entered (for input and bidirectional 
fields) by the workstation operator. Editing also affects the field’s internal length, and in 
some cases it restricts a field to handling output data only. 


How editing determines the workstation display and operator entries is especially 
obvious with edited numeric fields that are used for input. 


Assume that during the format’s creation a numeric input field is described as follows: 


$9,999.99 
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Since the SFG automatically protects a fixed currency sign, the field will be displayed as 
follows when the format is presented at the workstation: 


As long as the program indicates the number of decimal positions (two in this case), 
the workstation operator can make entries similar to any one of the following: 


$1,234.56 
$1.23. 
$1234.56_ 
$1234 


Decimal point alignment is done automatically (by the SFC). If no decimal point is 
entered (e.g., $1234), it is assumed to be to the right of the rightmost digit ($1234. ). 
Errors are indicated by blinking if the workstation operator makes an incorrect entry, 
such as: 


$123456__ 


The entry is in error because only four digits to the left of the decimal point are 
permitted (as indicated by the editing specified during the format’s creation and the 
number of decimal places provided for in the program). If the workstation operator 
enters too many digits to the right of the decimal point (e.g., $123.456), the value is 
accepted but the last digit (6) is truncated. 


Suppose you want this field to be displayed on the workstation as follows: 


$_, +L 
In this case, you perform the same editing ($9,999.99), but in addition you specify 
protection for the comma and the decimal point. The workstation operator must then 
enter the value in its proper position according to the field display. If the value is 1.23, 
the operator enters: 


$0,001.23. 


Now consider format fields that use the sign +, -, CR, or DB. If you describe an input 
field as +999 or -999 during format generation, it will appear as _ —— — when the 
format is displayed at the workstation. As long as the program indicates a sign for this 
field (e.g., S999 as in COBOL), the workstation operator can enter any 3-digit value 
with or without a sign. For example: 


+123 
-123 
123_ 


The value with no sign is assumed to be positive. 
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For output fields using a sign, the (COBOL) rules in Table 2-1 apply. 
Table 2-1. Editing Rules for Signed Output Fields 


If the Field And the Output _ Then the Output Is 
Is Defined with Value Is Displayed on the Format 
with 


+ (+999) Positive or zero + (+ 123) 
Negative - (-123) 


Positive or zero Space ( 123) 
Negative - (-123) 


CR  (999CR) Positive Two spaces (123 ) 
Negative CR (123CR) 


DB (999DB) Positive or zero Two spaces (123 ) 
Negative DB (123DB) 


Fields that use the exclamation point (!) for editing are displayed on the format with 
whatever character you choose to replace the exclamation point with. Assume that you 
define the following field during the format’s generation (pass 2). 





SOCIAL SECURITY :999!99!9999 


Later on during generation, you select a dash (-) to replace the exclamation point. If the 
field is used for input, it will be displayed as follows: 


SOCIAL SECURITY: ___-__-___ 
The operator can make the appropriate entries. If the field is used for output, it will 
display the data that is passed from your program to the format. For example: 


SOCIAL SECURITY: 195~44-8867 


Remember that edit characters used for simple or fixed insertion (such as B, O, $, +, -, 
CR, DB, !, and ,) are never counted in the field’s internal length. Also, fields containing 
any acceptable combination of the floating signs $, +, or -; the insertion characters CR 
or DB; or the suppression/replacement characters * or Z may only be used to display 
output data. 
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& Table 2-2 lists some editing examples and the effects of that editing on the format 
fields. 
and 


Table 2-2. Editing Examples 

















Type Attributes 








Internal 
Length* 


External 
Length 







Field Display 
INPUT:_ ~ _ 
OUTPUT: ABC 


OUTPUT : ABC-DEF 
(if dash is selected 
for replacement) 









INPUT:_ _ _ 
OUTPUT: #1A 






INPUT: . ~-_ _-_ _ 
OUTPUT : #1-23-AB 
(if dash is selected 

for replacement) 


OUTPUT ;ONLY:A3 4500BC 


INPUT:_ _ _ 
OUTPUT: 123 


















INPUT:~ ~ _/_ _-/_- 
OUTPUT: 12/24/80 

(if slash is selected 

for replacement) 








INPUT:$..~ 2-22-20 _- 
or (if , and . are protected) 
INPUT:$_,. __.-- 
OUTPUT :$1,234.56 


OUTPUT ONLY:123.45 
or 

12.34 
OUTPUT ONLY:$12.34 


or 


$1.23 





Alphabetic 
AAA!IAAA 
Alphanumeric 
| 
“Internal lengths indicated are based on the internal usage of display. 


Field Type 
Editing Specified 
ZZ9.99 5 
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3. Using the Screen Format 
Generator (SFG) 


3.1. ACTIVATING THE SFG 


The first thing you must do to perform any of the SFG functions is activate the SFG. Do 
this on the workstation: 


1. Key in LOGON and your user ID. 

2. Press the XMIT key. 

3. Get into system mode. 

4. Key in RV SFGEN. 

5. Press the XMIT key. 

A formatted display called the home screen then appears on the workstation screen. 
The home screen is like a fill-in-the-blanks form: you enter the function you want to 
perform, as well as information about your screen format. 

3.2. THE HOME SCREEN 

The home screen (Figure 3-1) is always the first display presented whenever you 
activate the SFG. On it, you choose one of the eight SFG functions. If you're working 
on a format that already exists, you provide its name and library. If you're creating a 


new format, you name it, indicate where it will be stored, and, if necessary, allocate file 
space for it. 
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1. FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

2. 5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 

3. OLD FORMAT NAME (¢ _) IS ON THE FOLLOWING LIBRARY: 

4. FILE NAME: ($YSFMT ) VOLUME: (RES 

5. 

6. NEW FORMAT NAME (¢ ) IS TO BE STORED ON THE FOLLOWING LIBRARY: 

7. FILE NAME: ($YSFMT ) VOLUME: (RES ) 
8. IF THIS FILE DOES NOT EXIST, ALLOCATE (902) CYLINDERS. INCREMENT IS (@1) CYL. 
9. 

10. **FUNCTION KEYS ARE:F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, 

11. F13-HELP, F14-EXIT HELP, F2@-RESTORE SCREEN 





Figure 3-1. The Home Screen 


Subsection 3.6 discusses how to position the cursor and how to overwrite values on 
the screen. 


3.2.1. Functions Provided by the SFG @ 





On line 1 of the home screen, you specify one of the eight functions provided by the 
SFG: 


FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 
5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 


m CREATE 


Use this function to create a screen format. The first step is to complete and 
transmit the home screen. The SFG then displays another fill-in-the-blanks screen 
called the characteristics screen. This screen asks you for format-related 
information and offers several options. Some of these options have other screens 
associated with them. If you choose these particular options, their optional screens 
are also displayed. 


Once you've provided all the necessary information about your format, a blank 
screen is displayed for you to lay out your screen format. You supply any display 
constants and indicate any variable fields and their lengths. In two subsequent 
passes, you assign type (editing) attributes and input/output usages for each field 
on the format. 
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@ You also have the option of providing more information for each field in the format 
by initiating dialogs for those fields. Once your format is complete and transmitted, 
the home screen is displayed for you to choose another function. 


m= CREATE-FROM 


Use this function to create a new format by modifying an existing format. You can 
change the format as a whole, or you can change specifications on some or all of 
the fields in the format. The SFG saves the old format. 


= MODIFY 


Use this function basically as you use the CREATE-FROM function. The only 
difference is that the SFG doesn’t save the old format. The new format replaces 
the old format. 


m DELETE 
Use this function to delete an existing format. 
= SHOW 


Use this function to display an existing format and its type attributes on the 
workstation screen. 


as LIST 


Use this function to display information for each field within an existing format. The 
display includes such information as the creation date, the location of the fields on 
the screen format (x,y coordinates), input/output usage of the fields, internal and 
external field lengths, range checking and replenishing values, and conditional 
indicators associated with the field. 


=» SPOOL 


Use this function to get a printout of an existing screen format, along with the field 
information provided by the LIST function. 


mw TERMINATE 


Use this function to terminate the SFG session and return control to the system. 
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3.2.2. New Format Name and Library 


Every screen format must have a name and library. When you're creating a format, 
name it and indicate where it will be stored via lines 6 and 7 of the home screen: 


NEW FORMAT NAME ( ) IS TO BE STORED ON THE FOLLOWING LIBRARY: 


FILE NAME: ($YSFMT ) VOLUME: (RES ) 


Line 6 asks for the format name. The name can be eight characters and can contain 
only the letters A to Z, the numerals O to 9, and the special characters 


‘#$ @ and? 

Spaces are not allowed within the name. 

Lines 6 and 7 ask for the library where the format will be stored. $Y$FMT is a system 
file for storing formats; it is the default for FILE NAME. $Y$FMT resides on the system 
resident volume (RES). Thus, RES is the default for VOLUME. If you choose the defaults, 
no keyin is required. You're ready to transmit the home screen. You can, however, 
store your format on an alternate MIRAM library. To do so, overwrite $Y$FMT and RES 
with the appropriate file name and volume name. 


If the alternate file you specify doesn’t exist (hasn't been allocated), allocate space for it 
on the volume. Line 8 asks about the file space you need: 


IF THIS FILE DOES NOT EXIST, ALLOCATE (002) CYLINDERS. INCREMENT IS (01) CYL. 
If you need more than two cylinders for your file, overwrite the O02 (the default) with 
the number you need. The same applies for INCREMENT, which is the number of extra 
cylinders added to your file each time the file fills up. 
The CREATE function isn’t the only function that requires a new format name. The 
CREATE-FROM function also needs a new name because you're creating a whole new 
format based on the characteristics of an old one. The old format itself does not 
change, nor does its name. 
3.2.3. Old Format Name and Library 
The functions that require the old format name and library are: 

CREATE-FROM SHOW 

MODIFY LIST 


DELETE SPOOL 
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On lines 3 and 4, enter the name and library of the format you want to work with. If 
the format is stored on $Y$FMT, no further keyin is required. Just transmit the home 
screen. If the format is stored on some other library, enter the file name and volume 
where the format is located and then transmit the home screen. 


NOTE: 


To get a listing of existing format names, issue the FSTATUS command. For an 
explanation of this command and accompanying parameters, refer to the interactive 
services concepts and facilities user guide/programmer reference. 


3.3. THE CHARACTERISTICS SCREEN 


When you're creating a new format, the next screen displayed after the home screen is 
the characteristics screen. This screen (Figure 3-2) asks for more information about 
your format. 


GLOBAL CHARACTERISTICS FOR FORMAT XxxXxXxxxx! 

LOWER CASE TRANSLATION? (1): 1 YES 2 NO 

ALPHABET: (ENGLISH_) SCREEN FORMAT IS (1): 1 ORIGINAL 2 OVERLAY 

ERASE/UNLOCK OPTION (1): 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 


ERROR RETRY COUNT: (02) SPECIAL EDITING CHARACTERS? (1): 1 NO 2 YES 
SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 


DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (1): 1NO 2 YES 
DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 

0. FUNCTION OR COMMAND KEYS TO BE DEFINED? (1): 1 NO 2 YES 

1 DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1 NO 2 YES 


= _2 OA WN OU FWD 





Figure 3-2. The Characteristics Screen 


Some selections on the characteristics screen prompt additional screens. These are 
called optional screens and are discussed in 3.4. Optional screens further define certain 
run-time characteristics of your format. They automatically appear in sequence after you 
complete and transmit the characteristics screen. 


Note that the first line of the characteristics screen always contains the format name 
you supplied on the home screen: 


GLOBAL CHARACTERISTICS FOR FORMAT xxxxxxxx: 


where xxxxxxxx is the 8-character name of your format. 
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3.3.1. Lowercase Translation (Line 2) 


Line 2 asks you to specify whether lowercase alphabetic characters, entered by the 
workstation operator for the format’s variable data fields, will be translated to 
uppercase before being passed as input to your program. 


LOWER CASE TRANSLATION? (1): 1 YES 2 NO 


As indicated by the parentheses, the default value for the question is 1 (YES). If you 
accept the default, lowercase alphabetic characters provided as input by a workstation 
operator are translated to uppercase before they are passed to the program. If you 
select 2 (NO), lowercase alphabetic characters aren't translated to uppercase. 


NOTE: 


No lowercase translation may be performed on Katakana workstations; therefore, you 
must overwrite the default value with 2 (NO), specifying no lowercase translation. 


3.3.2. Alphabet (Line 3) 


If you're creating (CREATE or CREATE-FROM) or modifying (MODIFY) a format, line 3 
lets you indicate whether input provided by a workstation operator at run time is in a 
language other than English: 


ALPHABET: (ENGLISH_) 


English is the default alphabet. Appendix D lists the other valid alphabets for which 
translation tables are available. 


3.3.3. Original and Overlay Formats (Line 3) 


An original format is simply the average screen format whose purpose is inputting and 
outputting information to and from your program. An overlay format serves the same 
general purpose; however, it is created for use with an original format. Your response 
to this part of line 3 indicates whether the format you're creating or modifying is an 
overlay or an original. 


SCREEN FORMAT IS (1): 1 ORIGINAL 2 OVERLAY 


An overlay format is created separately and may start at the beginning of any line on 
the screen. When selected by your program, it completely replaces (overlays) a portion 
of or acts as an addition to the original format that’s already displayed. At this time, 
only the overlay format is used for inputting and/or outputting because it’s the only 
format recognized. The original format remains unchanged and exists only for display 


purposes. Creation of an overlay format and specific examples of its use are discussed 
in 4.3. 
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3.3.4. Erasing and Unlocking Options (Lines 4 and 5) 


When your program first displays a format on a screen, output-only and bidirectional 
fields contain data from your program, and input fields are ready to be filled in. When a 
workstation operator completes the format and transmits it back to your program, the 
next thing that occurs depends on the erase/unlock option you specified when you 
created the format. Your choices are displayed on lines 4 and 5 of the characteristics 
screen: 


ERASE/UNLOCK OPTION (1): 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 


m@ NONE 


This is the default option. It indicates that when a workstation operator transmits a 
format the SFC verifies the input data. When verification is completed, the screen 
format itself remains on the workstation screen and the keyboard remains locked 
until your program requests the display of the same or a new format. This option 
offers you the most flexibility, in that your format isn’t redisplayed automatically. If 
you intend to use conditional indicators to control your format’s run-time 
characteristics (discussed later in this section), specify either this option or the 
CONDITIONAL INDICATOR IN USER PROGRAM option. 


m REPLENISH SCREEN 


This option indicates that when a workstation operator transmits a format the SFC 
verifies the input data. Then, if verification is successful, the SFC immediately 
replenishes the input-only fields with a stringed constant (normally underlines) 
without waiting for your program to actually accept the input. The keyboard is then 
unlocked. Thus, a workstation operator can begin filling out another screenful of 
data without waiting for your program to process the previous input data. This 
option is designed specifically for data entry applications that simply gather 
information from one format with a minimum of input verification. The formats 
should contain only input fields and should rely only on the verification that the SFC 
can perform. 


m ERASE SCREEN 


This option indicates that after your program displays a format and an operator 
transmits the contents back to your program, the format is erased and the 
keyboard is unlocked. This option is recommended for applications that only 
intermittently use screen formats. It is not recommended for continuous data entry 
applications because there is no looping back to redisplay a format. 
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m= UNLOCK KEYBOARD 


This option indicates that when an operator transmits a format, the SFC verifies the 
data, leaves the keyboard unlocked, and immediately allows a workstation operator 
to enter new data. It doesn’t wait for your program to accept the input before it 
allows an operator to enter the next screenful of data. In this respect, it resembles 
the REPLENISH SCREEN option. The difference between the two is that UNLOCK 
KEYBOARD doesn’t replenish input fields with a stringed constant (typically 
underlines). Instead, it leaves the screen display as is, where input fields contain 
the previously entered data. All a workstation operator has to do is overwrite the 
old contents of the field with new data. Like REPLENISH SCREEN, this option is 
recommended for data entry applications where formats contain only input fields 
that require a minimum of verification. 


m CONDITIONAL INDICATOR IN USER PROGRAM 


This option lets you set conditional indicators that determine your format'’s status. 
Depending on the conditions you specify and test for in your program, the input 
fields are replenished, the entire format is redisplayed, or the whole format is 
erased. You supply conditional erase/replenish indicators on an optional screen 
called the conditional erase/replenish screen. This screen (as well as any other 
applicable optional screens) appears after you complete and transmit the 
characteristics screen. For an explanation of the conditional erase/replenish screen, 
see 3.4.2. 


A user program may erase the screen format or replenish input values by issuing 
explicit statements (e.g. a BAL programmer would use consolidated data management 
macros). The keyboard may also be unlocked this way. NONE or UNLOCK KEYBOARD 
should be chosen in this case. See 7.3.4 and the consolidated data management macro 
language user guide/programmer reference for the data management macros that can 
be used for screen control. 


NOTE: 

Do not specify REPLENISH SCREEN, ERASE SCREEN, or UNLOCK KEYBOARD if you 
intend to use range checking for any field in your format. 

3.3.5. Error Retry Counts (Line 6) 


Your answer to this question determines the number of times a workstation operator 
may attempt to correct any input that is entered incorrectly. 


ERROR RETRY COUNT: (2) 
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The value 2 is the default value for the number of times correction may be attempted. 
However, you may specify any value up to 99 by overwriting the default. If you specify 
O, the operator can’t perform a retry. 

At run time, incorrect input is blinked (or displayed with the display attributes you select 
for fields entered in error) to the workstation operator. If the operator can’t correct the 
input and the value specified for the retry count is reached, then an error status is 
returned to your program. You may make provisions within your program for this 
situation. 

3.3.6. Special Editing Characters (Line 6) 

This line asks if you'll use special editing characters for numeric edited fields: 


SPECIAL EDITING CHARACTERS? (1): 1 NO 2 YES 


If you specify YES, an optional screen called the edit screen appears after you've 
transmitted the characteristics screen. The edit screen is discussed in 3.4.3. 


3.3.7. Special Display Control (Line 7) 


Line 7 asks if you want to change the display properties of the different types of fields 
in your format: 


SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 
If you choose YES, you prompt the display of an optional screen called the special 
display screen (3.4.4). On the special display screen, you can indicate the intensity and 
emphasis for display constants, input and output fields, and fields where an operator 
has made an error. If you accept the default, NO, the default display properties are: 
= Low intensity and no emphasis for display constants and output fields 


= Normal intensity and no emphasis for input fields 


m= Blinking for fields in error 
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3.3.8. Error Message Field (Line 8) 


You have the option of specifying where error messages from your program are 
displayed on your format, under what conditions they should appear, and how they look 
when they are displayed. To request an error message field, respond to line 8 of the 
characteristics screen: 


DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (1): 1 NO 2 YES 


If you answer (2) YES, you prompt the display of the optional error message screen 
(3.4.5.) 


3.3.9. Display Retention (Line 9) 


Line 9 lets you request conditional display retention for your format. Conditional display 
retention means that, under certain circumstances, the contents of all variable data 
fields remain displayed on the screen after a workstation operator transmits the format. 
Input fields aren't replenished with underlines (or other stringed constant); instead, they 
retain the values the workstation operator keyed in. Similarly, output and bidirectional 
fields don’t receive new values from your program. The only thing the SFC actually 
sends out to your format is the field display attributes (i.e., the intensity and emphasis). 
Conditional display retention has various uses that are discussed in more detail in 3.4.6. 
To request display retention for your format, respond to line 9 of the characteristics 
screen: 


DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 


By responding with 2 (YES), you prompt the display of an optional screen called the 
display retention screen (3.4.6). 


3.3.10. Function Keys (Line 10) 


You can assign your own functions or commands to function keys 1 through 22 on the 
keyboard. At run time, an operator simply depresses the appropriate keys to execute 
the function you've assigned to it in your program. By replying (2) YES to line 10 of 
the characteristics screen, 


FUNCTION OR COMMAND KEYS TO BE DEFINED? (1): 1 NO 2 YES 


you prompt the display of the function/command key screen (3.4.7), where you select 
the keys you want to use, along with their run-time indicators. 
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3.3.11. Nondisplayed Field (Line 11) 


Each format is allowed one field that communicates with your program but never 
appears on the workstation screen. When you enter 2 (YES) on line 11 of the 
characteristics screen, 


DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1 NO 2 YES 


you prompt the display of the nondisplay screen (3.4.8), where you specify how the 
field will be used. 


3.4. OPTIONAL SCREENS 


There are seven optional screens associated with the characteristics screen. Each one 
gives you additional control over some run-time feature of your format. 


The selections from the characteristics screen that prompt optional screens are listed in 
Table 3-1 and discussed in the following paragraphs. Note that whatever you specify 
on an optional screen affects every field in your format at run time. Some of the 
functions that optional screens provide, however, can be specified at the field level via 
a dialog screen. (Dialog screens are discussed in 3.5.) For example, you can specify 
display retention at the screen level as well as at the field level. However, at run time, 
your field level specification always overrides what you specify at the format level. For 
easy reference, the dialog screens that correspond to optional screens are also listed in 
Table 3-1. 


Table 3-1. Characteristics Screen, Related Optional Screens, and Related Dialog Screens 


Selection from Resulting Corresponding 
Characteristics Screen Optional Screen Dialog Screen 


ERASE/UNLOCK OPTION (5): Conditional erase/ 
CONDITIONAL INDICATOR IN replenish screen 
USER PROGRAM 


SPECIAL EDITING CHARACTERS? Edit screen Dialog screen 2 
(2): YES 


SPECIAL DISPLAY CONTROL? (2): Special display screen Dialog screen 4 
YES 


DO YOU WISH TO SPECIFY AN Error message screen 
ERROR MESSAGE FIELD? (2): YES 


DISPLAY RETENTION ON ALL Display retention screen Dialog screen 5 
FIELDS? (2): YES 


FUNCTION OR COMMAND KEYS TO Function command/key 
BE DEFINED? (2): YES screen 


DOES THIS FORMAT HAVE A NON- Nondisplay screen 
DISPLAYED CONSTANT? (2): YES 
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If you request any optional screens, they automatically appear, in the order discussed in 
the following subsections, after you transmit the characteristics screen. Once you 
complete and transmit the optional screens you requested, you're presented with a 
blank screen for laying out your format (pass 1, 4.1.1). 


Some general rules to keep in mind when working on optional screens are: 


1. If you change your mind about using an optional screen but the screen has already 
come up on your workstation, just transmit the screen without entering anything on 
it. The SFG then accepts the default values for that option. 


2. You must correct all errors (indicated by blinking or message) before you can 
successfully transmit an optional screen. To ignore warning messages, position the 
cursor at the end of the screen and press the transmit key. 


3. You can initiate the HELP function at any point. 


4. Rules concerning the position of the cursor are the same for optional screens as for 
the home screen (3.6.) 


Many optional screens, as well as many dialog screens, require conditional indicators. 
Before we discuss optional screens, it will help you to understand what these indicators 
do. 


3.4.1. Conditional Indicators 


Conditional indicators are a means of conditionally controlling certain run-time features 
of your format. In your program, you define a set of conditions under which you want a 
particular feature of your format (or a single field) to change. To each condition, you 
assign a number that serves as an indicator. You enter this indicator number on the 
optional screen or dialog screen associated with the feature you want to control. At run 
time, your program tests to see if that condition is true. If it is, it ‘‘turns on” the 
indicator. The indicator acts as a flag to the SFC, telling it to alter that feature of the 
format or field. 


You can associate a single indicator with more than one optional or dialog screen. That 
is, one indicator number can control several different run-time features of your format. 
For example, a single indicator can cause your program to display an error message, 
highlight a field in error, and even protect the other fields that an operator entered 
correctly. 


There are four ways of specifying how an indicator should work: 
a (Y nnn) syntax 


This is how the indicator is normally used. The Y implies that some action is taken 
when a condition is true and your program turns an indicator on. 
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@ (N nnn) syntax 


By overwriting the Y with an N (the Y is not protected), you specify that some 
action is taken only when an indicator is off (that is, only when the condition in 
your program is false). 


m (Y 000) syntax 


By entering zeros instead of a number or by leaving the indicator field blank, you 
set up an unconditional indicator. It means that some action (like display retention) 
always applies. (In effect, the condition is always true.) 


m (NOOO) syntax 


This, too, is an unconditional indicator. It means that some action (again, like 
display retention) never applies. (The condition is always false.) You can achieve 
the same effect by leaving the field blank, rather than filling in zeros. 


Use of the unconditional syntax is sometimes discouraged or redundant, depending on 
the application. Where this is true, it is noted in the following discussions of optional 
screens and dialog screens. 


The fields for the indicator numbers that appear on optional and dialog screens are 
three character spaces long. If your indicator is less than three characters, you still enter 
the first number at the first character slot. For example, you enter indicators 1, 12, and 
123 as follows: 


(Y 1) (Y 12.) (Y 123) 


NOTE: 


RPG Il users are limited to indicator numbers 1 to 99. 


3.4.2. Conditional Erase/Replenish Screen 


Remember that each time an operetor transmits a format, the next step the screen 
format coordinator takes depends on how you responded to lines 4 and 5 of the 
characteristics screen when you created the format: 


ERASE/UNLOCK OPTION (ep: 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 


By selecting 5 (CONDITIONAL INDICATOR IN USER PROGRAM), you prompt the display 
of the conditional erase/replenish screen (Figure 3-3). This screen lets you specify two 
indicators that conditionally control your screen format’s status. The two indicators you 
can specify are a replenish indicator and an erase indicator. 





UP-8802 Rev. 2 SPERRY UNIVAC OS/3 3-14 


SCREEN FORMAT SERVICES 





NO UV PWN 


ENTER THE CONDITIONAL ACTION DESIRED AFTER INPUT FOR FORMAT nnnnnnnn 


DO YOU WISH ALL INPUT-ONLY FIELDS TO BE REPLENISHED AFTER INPUT 


BASED UPON A CONDITIONAL INDICATOR? (1): 1 NO 2 YES INDICATOR (Y ___ 


DO YOU WISH TO HAVE THE SCREEN ERASED AFTER INPUT 
BASED UPON A CONDITIONAL INDICATOR? (1): 1 NO 2 YES INDICATOR (Y ___ 





Figure 3-3. Conditional Erase/Replenish Screen 


When you specify a replenish indicator, this is what happens: 


Step 1 


Your program displays a format at a workstation screen. (The format can contain 
any combination of output, input, and bidirectional fields.) 


Step 2 
A workstation operator fills in and then transmits your format. 
Step 3 


The SFC accepts the data from the format and performs its own validation on the 
input. If successful, it then passes the input to your program. The keyboard 
remains locked. 


Step 4 


Your program performs its own validation of the input. If and when the input meets 
a condition your program is testing for, it decides that only the input-only fields 
should be replenished. Your program then turns on your replenish indicator and 
signals the SFC. 


Step 5 


The SFC replenishes your input-only fields with a stringed constant (like underlines) 
and unlocks the keyboard. /t doesn’t replenish bidirectional and output fields. That 
is, these fields don't receive new output from your program. They retain the values 
they had when the operator transmitted your format at step 2. The associated 
attributes of output and bidirectional fields are rewritten, however. 


When the SFC replenishes the input fields and unlocks the keyboard, the workstation 
operator can enter new data. This time when the operator transmits the format, the 
complete record that the SFC accepts and sends back to your program consists of the 


new data the operator just supplied, as well as the data that was retained in the output 
and bidirectional fields. 
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To enter a replenish indicator on the conditional erase/replenish screen, you must first 
answer the question on line 4 and then enter an indicator number: 


DO YOU WISH ALL INPUT-ONLY FIELDS TO BE REPLENISHED AFTER INPUT 
BASED UPON A CONDITIONAL INDICATOR? (1): 1 NO 2 YES INDICATOR CY ___) 


The erase indicator you supply on line 7 of the conditional erase/replenish screen lets 
your program conditionally erase the entire screen format. The erase indicator acts as a 
signal to the SFC to completly erase, and thus end, the display of a particular format. 
Typically, you use an erase indicator to signal the end of a workstation session. Like 
the replenish indicator, your program decides when to turn an erase indicator on, based 
on the input it receives from a workstation operator. 


The steps described for the replenish indicator apply also to the erase indicator through 
step 3. At that point, the following occurs: 


m Step 4 


Your program validates the input. If it meets criteria, your program turns the erase 
indicator on and signals the SFC. 


= Step 5 
The SFC, in response, erases the workstation screen and unlocks the keyboard. 


To enter an erase indicator on the conditional erase/replenish screen, you must first 
answer the question on line 7 and then enter an indicator number: 


DO YOU WISH TO HAVE THE SCREEN ERASED AFTER INPUT 
BASED UPON A CONDITIONAL INDICATOR? (1): 1 NO 2 YES INDICATOR (Y ___) 


So far, we've discussed what happens when either a replenish or an erase indicator is 
on. The other possibility, not yet covered, is what happens when neither indicator is on. 
When this is the case, your format remains under the normal control of your program 
(as it would be if you specified NONE as your erase/unlock option). The screen format 
remains on the workstation screen and the keyboard remains locked until your program 
requests the display of the same or a new format or, perhaps, turns on other indicators 
that affect your format’s run-time characteristics. 


For a sample format that uses the conditional erase/replenish option, see 4.2. 


NOTE: 


Your replenish and erase indicators take precedence over any other indicators you 
specify. All other indicators are ignored in this type of output operation. 
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3.4.3. Edit Screen 


The edit screen (Figure 3-4) is displayed only if you elect, via line 6 of the 
characteristics screen (SPECIAL EDITING CHARACTERS? (1): 1 NO 2 YES), to replace 
certain numeric edit characters with those of your choice. 


You specify a special edit character by overwriting the character that appears in 
parentheses. You could, for example, overwrite the currency sign ($) with the pound 
symbol (#). You must then use the special edit character (#) instead of the currency sign 
when completing the type attribute screen in pass 2. Thus, a numeric edited field might 
be displayed on the completed format as #9,999.99 instead of $9,999.99. 


Using the edit screen, you may select a character other than the underline (—) to 
replenish all input and bidirectional fields. You can also do this on a field-by-field basis 
by using dialog screen 2 (3.5.2). 









ENTER EDIT CHARACTERS IN PARENTHESES TO BE USED FOR FORMAT nnnnnnnn 










STANDARD CHAR : MEANING: = CHAR TO BE USED 
$ : CURRENCY SIGN = ($) 
- = DECIMAL SYMBOL = (.) 
, = THOUSANDS PUNCT. = (,) 
* : REPLACEMENT CHAR = (*) 
CR: CREDIT ON NEGATIVE = (CR) 
DB: DEBIT ON NEGATIVE = (DB) 
- : REPLENISH CHAR = (_) 


NOTE: MAKE SURE NO SYMBOL IS AMBIGUOUS WITH ANY VALID PICTURE STRING CHARACTER. 





Figure 3-4. Edit Screen 


NOTE: 


For Katakana, the default currency sign on the edit screen is the yen (¥) instead of the 
dollar sign ($). 


Some general rules pertaining to the completion of the edit screen are: 

1. Special edit characters must be the same length as the original. 

2. With the exception of the replenishing character, you may not select any of the 
following as special edit characters: !, 9, A, X, O (zero), B, E, +, - (minus), Z, L, H, 


or the underline. 


3. Special edit characters must not be ambiguous and must be different from each 
other. 


4. If you enter an unacceptable edit character, it will be blinked. The edit screen can’t 
be transmitted until you correct all errors. 


5. If you decide you don’t want to select any special edit characters, simply transmit 
the edit screen as is. 
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6. You may request help or return to the home screen by using the appropriate 
function keys (F13 and F1). 


7. If you want your program to receive the underline character (_) that an operator 
keys in to an input or bidirectional field, you must specify a blank as the replenish 
character. Otherwise, if you use the underline as your replenish character, the SFC 
automatically translates any underlines it detects to blanks. Thus, the underline the 
operator keys in will never make it back to your program. 


Note that if you use blanks as your replenish character, the workstation operator can’t 
see where input fields begin and end. (No stringed constant appears after a display 
constant.) If the workstations you use are model 2 (UTS 40D) terminals, you can get 
around this restriction. The model 2 workstations let you treat underlines as a display 
attribute that you specify on a field-by-field basis. See dialog screen 4 (3.5.4) for 
details. 


3.4.4. Special Display Screen 


By requesting special display control on the characteristics screen, you prompt the 
special display screen to appear as shown in Figure 3-5. 


1. ENTER THE DISPLAY PROPERTIES FOR FORMAT nnnnnnnn: 

2. INTENSITY EMPHASIS: 

3. DISPLAY CONSTANTS (B) 

4. OUTPUT VARIABLES (B) 

5. INPUT CAPABLE FIELDS (A) 

6. FIELDS ENTERED IN ERROR (A) 

Te 

8. INTENSITY: EMPHASIS: 

9. A. NORMAL INTENSITY 1. UNDERLINED 4. REVERSE VIDEO 
10. B. ALTERNATE (LOW INTENSITY) 2. COLUMN SEPARATORS 5. BLINK FIELD 
11. 3. STRIKE THRU BARS 





Figure 3-5. Special Display Screen 


The special display screen lets you select the display properties for the four types of 
fields in your format: display constants, output variables, input variables (those defined 
as input-only or bidirectional), and fields where an operator has made an error entering 
data. 


When the special display screen first appears, it contains the SFG defaults for intensity 
and emphasis (the letters A and B and the numbers 1 through 5 refer to the key that 
appears at the bottom of the screen). The defaults are: 
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# Output fields: low intensity (B), no emphasis 

= ~=Input fields: normal intensity (A), no emphasis 

= Display constants: low intensity (B), no emphasis 

w= Fields in error: normal intensity (A), blinking emphasis (5) 

You can change one or all the SFG defaults by entering your own choices. For each 
field, you can specify one intensity and up to five different types of emphasis. For 
example, you can specify that fields in error be displayed in normal intensity along with 


blinking, underlining, and reverse video, all at the same time. You would simply fill in 
line 6 of the special display screen as follows: 


INTENSITY EMPHASIS 
FIELDS ENTERED IN ERROR (A) Tw» 


When specifying display combinations, keep in mind the operator who will be using 
your format. Some display combinations could result in eyestrain. 


The specifications you make on the special display screen become the new defaults for 
your format. As you'll see in 3.5.4, you can override the format specification for 
individual fields via dialog screen 4. 


NOTE: 


Not all display properties are supported by all devices. If the type of workstation where 
your format is being used doesn’t support the display combinations you selected, the 
system selects alternate display properties at run time. Appendix E lists these alternate 
display properties. 


3.4.5. Error Message Screen 

If you want the ability to display an error message from your program on a workstation 
screen, you must designate a field for it on your format. Through the error message 
screen, you can specify where and when the error message is displayed, as well as 
how it should look. You prompt the error message screen by responding as follows to 
line 8 of the characteristics screen: 


DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? B: 1 NO 2 YES 


Figure 3-6 is a display of the error message screen as it first appears. 
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1. ENTER THE FOLLOWING INFORMATION FOR YOUR ERROR MESSAGES FOR FORMAT nnnnnnnn 
2. MESSAGE FIELD NAME IS: CERRORMSG ) 

3. NUMBER OF LINES IN ERROR MESSAGE: (1) ENTER 1 OR 2 

4. DISPLAY ERROR MESSAGE ON LINE NUMBER: (LAST) ENTER NUMBER OR 'LAST' 

5. ERROR MESSAGES CONDITIONALLY DISPLAYED: INDICATOR (Y ___) 

6. DISPLAY ATTRIBUTES: INTENSITY (A) EMPHASIS: 

?. 

8. INTENSITY: EMPHASIS: 

9. A. NORMAL INTENSITY 1. UNDERLINED 4. REVERSE VIDEO 
10. B. ALTERNATE (LOW) INTENSITY 2. COLUMN SEPARATORS 5. BLINK FIELD 
11. 3. STRIKE THRU BARS 





Figure 3-6. Error Message Screen 


The screen can be analyzed as follows: 
@ Line 1 


Displays the name of the error message field. The SFG assigns the name 
ERRORMSG to the error message field. If you prefer, you can enter your own, 
application-oriented name. It must be unique and must begin with an alphabetic 
character and can be a maximum of eight characters. It can contain any valid 
alphabetic character, the numerals O to 9, and the special characters $, #, a, x, @, 
and ?. No embedded spaces are allowed. 


= Line 3 


Asks you to designate one or two lines (60 or 120 characters) for your error 
message. The default is one line. Note that even if the text of your error message 
is less than 60 or 120 characters, you should assign either 60 or 120 characters 
for it in your program. This ensures that when your error message is displayed, the 
entire field is filled with either text or blanks. Otherwise, since the SFC expects 
either 60 or 120 characters, it could fill the field in with meaningless data from 
your work area. 


a Line 4 


Displays the location of the error message field. The error message field location 
defaults to the last line of the screen. You can, however, specify an actual line 
number (or numbers for 2-line messages) indicating where you want the error 
message to appear. You should be careful, however, not to choose a line that will 
contain input or bidirectional fields. If you inadvertently do so, the screen format 
generator won't detect it; at run time it could result in erroneous data being 
returned to your program, or you'll get an error message from the SFC. 
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m@ Line 5 


Asks you for a conditional indicator. If your program detects an error when it 
validates input, it can turn on the error message indicator. The SFC, in response, 
displays the error message on your format. (You can also use the N nnn form for 
the indicator, where as long as the indicator is on, the error message is not 
displayed. When the indicator is off, it is displayed. Unconditional indicators aren't 
suitable for this feature.) 


mw Line 6 


Displays the default display properties (intensity and emphasis qualities) for the 
error message field. The defaults are normal intensity (A) and no emphasis. To 
specify your own choice of display properties, overwrite the default values, using 
the key at the bottom of the screen for reference. You can combine one intensity 
with as many as five types of emphasis. 


a Lines 9 through 11 


Display a key for entering your choice of display properties. The letters A and B 
refer to intensities, and the numbers 1 through 5 refer to types of emphasis. 


NOTES: 


1. The error message field must be the last field you define in the output record area 
of your program. 


2. The error message indicator overrides any other user-specified retain options. 


When the error message indicator is on, the display of the message isn’t the only thing 
that occurs. The SFC also retains the contents of all variable data fields on the screen 
and rewrites the display attributes of each field. This gives you two important 
advantages. 


First, your program typically displays an error message when an operator enters and 
transmits the wrong data. By retaining the contents of variable data fields, the operator 
can see exactly what he entered (and what caused your program to display the error 
message). 


Secondly, by completely rewriting the field display properties (the intensity and 
emphasis of each field), the SFC can highlight the field where the operator made the 
error. This ability to highlight a field in error involves more than what the error message 
screen can provide. To highlight a field, you need to specify a condtional indicator that 
controls its display properties. You specify such an indicator via dialog screen 4 (3.5.4), 
the special display properties dialog. 
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3.4.6. Display Retention Screen 
The display retention screen (Figure 3-7) lets you set an indicator that controls whether 


the contents of variable data fields are retained on the workstation screen. 


DO YOU WISH THE DISPLAY IMAGE TO BE CONDITIONALLY RETAINED 
FOR ALL FIELDS OF FORMAT nnnnnnnn? (1): 1 NO 2. YES 


INDICATOR (Y ___ 


CIF THIS IS SELECTED, AN OUTPUT COMMAND WILL AFFECT DISPLAY ATTRIBUTES ONLY 
UNLESS OVERRIDDEN AT FIELD LEVEL VIA DIALOG 5.) 


NOU FWD = 





Figure 3-7. Display Retention Screen 


Display retention occurs when your program receives data from your format and, based 
on the nature of the data, turns the retain indicator on. In response to the retain 
indicator, the SFC doesn’t change the text of the workstation screen. Output fields 
retain the values they previously received from your program; they aren‘t replenished 
with new values. Bidirectional fields retain either the value supplied by your program or 
the value a workstation operator keyed in over it. Input fields are left with the data the 
workstation operator keyed in; they aren't replenished with underlines or other stringed 
constant. 


The only thing the SFC actually rewrites to the screen is each field's display attributes 
(that is, their intensity and emphasis). If the display attributes don’t change, an operator 
won't notice a difference in the format. However, if the SFC sends out new display 
attributes to a field (such as blinking or reverse video), the operator will notice a very 
visible difference. 


You can use the display retention indicator with other indicators. For example, if your 
program detects an error in the input it received from your operator, it can turn on two 
indicators: a retain indicator that preserves the data on the screen, thus allowing an 
operator to see what he entered, and an indicator that changes the display attributes of 
the field in error, such that the field stands out from the others. When the workstation 
operator corrects the field in error and transmits the screen, the SFC accepts the newly 
corrected value the operator entered, as well as the other values that were retained on 
the screen. (See dialog screen 4 (3.5.4) for an explanation of how to conditionally 
control field display attributes.) 


You can also specify display retention at the field level via dialog screen 5. Note, 
however, that your field-level indicator always overrides the format-level indicator. This 
being the case, you can selectively retain all or just some of ‘the fields on your format. 


NOTE: 


The first time a format is written to a workstation screen, the SFC ignores any retain 
indicators you specify. 
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To supply an indicator on the display retention screen, you must first answer the 
question on line 2: 


DO YOU WISH THE DISPLAY IMAGE TO BE CONDITIONALLY RETAINED 
FOR ALL FIELDS OF FORMAT nnnnnnnn? (: 1 NO 2 YES 


You then supply the indicator number on line 4. (If desired, you can use the 
unconditional Y OOO or Y —. _. — forms of the indicator, as well as the N nnn form.) 


3.4.7. Function/Command Key Screen 


The function/command key screen (Figure 3-8) lets you designate which keys you 
assign your own program functions to. The allowable keys are function keys 1 through 
22 on the workstation keyboard. 


ENTER THE FUNCTION/COMMAND KEYS TO BE USED BY FORMAT nnnnnnnn 


KEY# ACCEPT? RESPONSE KEY# ACCEPT? RESPONSE KEY# ACCEPT? RESPONSE 
F1 (N) C F2 (ND Cicd F3 (N) (___) 

F4 (N) F5 (N) F6 (N) 

F7 (N) F8 (N) F9 (N) 

F10 (ND F11 (N) F12 (N) 


Ce 
Lo 
Re 
F13 (N) F14 (N) F15 (N) es 
C2 
a 


F16. CN) F17~—s(N) F18 = (N) 

F19 (ND F20. (ND F21 (N) 
F22.(N) oe 

(USE FUNCTION KEY#13 FOR HELP. THIS WILL EXPLAIN INDICATOR SYNTAX.) 


) 
) 
) 
) 
) 
) 





Figure 3-8. Function/Command Key Screen 


There are two ways of assigning function/command keys: 


m You can accept a key and assign a response indicator to it. When a workstation 
operator presses the key, the indicator is turned on and returned to your program, 
thus prompting some action to occur within the program. 


= You can simply accept a key without assigning a response indicator to it. When a 
workstation operator presses the key, your program is alerted to take a particular 
course of action. 


The difference between assigning indicators and not assigning indicators depends on 
how you code your program and the function you're using a key for. The indicators you 
specify for function keys are response inicators. They're different from any of the other 
indicators you supply to the SFG. The other indicators (called option indicators) are 
passed from your program to the SFC. Response indicators, on the other hand, are 
passed from the SFC to your program. Therefore, response indicators are handled 
differently in your program. Consult Section 7 for details. 














at 
» 


| 
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Normally, when an operator presses a function key associated with a response 
indicator, no data is sent to your program. Instead, your program receives either blanks, 
zeros, or default constant values. (A bidirectional field that has been conditionally 
protected or conditionally displayed returns the value it received from your program.) In 
addition, if an operator presses a function key that hasn't been accepted and which 
screen format services doesn’t use, an error message is sent to the workstation. The 
workstation operator must then acknowledge the message in system mode. 


NOTES: 


1. It is recommended that you use only function keys 2, 3, 4, and 6 through 10. 
Function keys 1, 5, and 11 through 22 are already defined by the system. If you 
do reassign a function key that the system uses, you'll lose that system function. 
Appendix C lists the SFC function keys. 


2. User-assigned function keys aren't supported in an IMS environment. 

3. Response indicators shouldn't be specified for RPG Il programs. RPG Il has a 
special set of indicators (KA-KN, KP-KW) for the function keys. F1-F14 corresond 
to KA-KN; F15-22 correspond to KP-KW. 

3.4.8. Nondisplay Screen 

The nondisplay screen (Figure 3-9) lets you define a single field that communicates with 


your program but never appears on the workstation screen. This can be used when 
there is some value or information that you don't want an operator to have access to. 


4, DESCRIBE THE SINGLE NON-DISPLAYED FIELD FOR FORMAT nnnnnnnn 

2. 

3. LENGTH OF THIS FIELD IS (__) 

4. VALUE OF FIELD IS (1): 

5. 1 - FIRST FIELD OUTPUT BY PROGRAM (FIELD IS BIDIRECTIONAL) 

6. 2 - FIELD IS INPUT-ONLY, VALUE IS: 

7. 

8. 

9. THIS VALUE IS ALWAYS THE FIRST INPUT FIELD WHICH IS NAMED: (FLDO0000) 
10. IF OPTION #1 IS SELECTED ABOVE, IT IS ALSO THE FIRST OUTPUT FIELD. 





Figure 3-9. Nondisplay Screen 


The nondisplayed field that you define must be the first field in the input or output work 
area in your program. It can be an input constant associated with the format, or it may 
be a variable. In the latter case, this bidirectional field is communication between the 
output and input logic of the program. The value is not available to the workstation 
operator to inspect or change. 
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In the former case, the input-only field is a constant that enables the program to take 
some action based on information stored in the format rather than in the program. 


The first question the nondisplay screen asks is the length of the field. The range of 
acceptable entries is 1 to 80. The second question the screen asks is whether the field 
is bidirectional or input-only. If input-only, you enter the constant value. The SFG field 
name (FLDOOOOO) appears on line 9. As with any other field name, you have the option 
of renaming it, using an application oriented name. 


3.5. DIALOG SCREENS 


After you transmit your optional screens (or, if you didn’t request optional screens, then 
after you transmit the characteristics screen), you're ready to set up your format. This 
involves three passes: in pass 1, you lay your format out on a blank screen; in pass 2, 
you assign editing attributes to variable data fields; in pass 3, you indicate field |/O 
direction and initiate dialog screens for the fields that require them. Dialogs, however, 
are also initiated automatically for any field defined with an exclamation point in pass 2 
or defined with edit characters that can be protected. Section 4 explains how to 
complete passes 1 through 3 and how you initiate dialogs. This subsection introduces 
and defines what the various dialog functions are. 


Dialog screens are used to place additional requirements on how information for certain 
variable data fields is to be handled at run time. They serve a purpose similar to the 
optional screens, only they affect individual fields rather than the whole format. 


Some dialogs let you set up conditional indicators that control how a field looks or 
behaves under certain conditions. These indicators are values you define in your 
program and on the appropriate dialog screen. At run time, they act as a signal to your 
format, telling it that a field is to be treated differently from the other fields on the 
screen. These indicators work the same way as the indicators used on the optional 
screens. Refer to 3.4.1 for a brief explanation of what the indicators do. 


Table 3-2 lists and briefly describes the seven dialog screens. 
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Table 3-2. Dialog Screens and Their Functions 
Dialog 
Screen 


Always first dialog displayed. Indicates 1/O direction, field name, internal field length, edit mask, and 
insertion characters and asks you if additional dialog screens are required 


Indicates field response and default and replenishing values. For input fields only 


Conditional display dialog. Specifies when a field will or will not appear at a workstation screen 


Special display properties dialog. Controls the display properties of individual fields 


Conditional retention dialog. Indicates when the contents of a field should be retained on a workstation 
screen 


Conditional protection dialog. Indicates when the contents of a field should be protected 


Range checking. Indicates what the valid range of values is for a field 





After transmission of the 1/O screen (pass 3), dialog screen 1 is always presented 
automatically for the first field requesting dialogs. 


If more than one field requests dialogs, the SFG handles the fields one at a time. When 
dialog screen 1 and any subsequent dialogs are completed for the first field, dialog 
screen 1 is automatically presented for the next field and so on until all the fields 
requesting dialogs have been satisfied. The creation of your format is then complete, 
and the home screen is displayed for you to choose another function. 


The following are some general rules to keep in mind when you're working with dialog 
screens: 


1. You must correct all errors (indicated by blinking or message) before transmission 
of the screen can occur. To ignore warning messages, position the cursor to the 
end of the screen and press the transmit key. 


2. You may terminate the session at any point via the F1 function key. No screen 
format is created, and the home screen appears for you to specify another 
function. 


3. You can initiate the HELP function at any point during dialogs. 


4. Positioning of the cursor before transmitting dialog screens is the same as 
described for the home screen (3.6). 
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3.5.1. Dialog Screen 1 (General Field Characteristics) 


Dialog screen 1 (Figure 3—10) is always the first dialog screen presented for any field 
requiring dialogs. On it you can specify an alternate field name, the I/O direction, the 
internal field length, edit mask, and insertion characters. It is also where you request 
dialog screens 3 through 7. 


‘Te display of the field 

2. 

3. (FLDnnnnn) IS FOR FIELD USE OF (1): 1 OUTPUT 2 INPUT 3 BOTH 

4. INTERNAL USAGE IS (1): 1 DISPLAY 2 PACKED 3 BINARY 4 ZONED 

5. INTERNAL LENGTH IS: (nn) 

6. PLEASE INDICATE WHETHER THE FOLLOWING ARE REQUIRED: 1 NO 2 YES 

7. CONDITIONAL DISPLAY (1) SPECIAL DISPLAY PROPERTIES (1) 
8. CONDITIONAL RETENTION (1) CONDITIONAL PROTECTION (1) 
9. RANGE CHECKING (1) 

10. REPLACE !'S IN THE FOLLOWING LINE BY INSERTION CHARACTERS 

11. display of the field 





Figure 3-10. Dialog Screen 1 





Each line of the format can be analyzed as follows: 
m Line 1 


This line displays the field requesting dialogs. It appears the way it was defined in 
pass 2 (the type attribute screen). If the field is the only one on a line, it appears 
by itself. However, if one or more fields requesting dialogs are located on the same 
line with other fields, the entire line, up to and including the field that requires 
dialogs, is displayed. 


For example, you could design your format with three fields on a single line like 
this: 


NAME SOCIAL SECURITY AMOUNT DUE 


If dialogs are requested for both the SOCIAL SECURITY and AMOUNT DUE fields, 
then line 1 of dialog screen 1 for the SOCIAL SECURITY field would look like this: 


NAME A, SOCIAL SECURITY: 99919919999 


Line 1 of dialog screen 1 for the AMOUNT DUE field would appear as: 


NAME A SOCIAL SECURITY: 99919919999 AMOUNT DUE: $99.999.99 
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=~ Line 3: 
(FLDnnnnn) IS FOR FIELD USE OF (1): 1 OUTPUT 2 INPUT 3 BOTH 


Shows a default name for the field (FLDnnnnn) and also lets you change the |I/O 
direction for that field from the choice made on the I/O screen. 


The SFG automatically gives a name to each variable data field in the format. This 
name is kept in a table that can be referenced for future modification (via the 
modify screen for the CREATE-FROM or MODIFY functions). These names are 
assigned as ‘FLDnnnnn’ sequentially, where O < nnnnn < 256. You can, however, 
assign your own logical field name by overwriting the default name in the 
parentheses. The logical name should be unique and should not be a duplicate of 
an SFG-provided name. It must start with an alphabetic character, must not 
contain an embedded blank, and must not exceed eight characters. The only 
acceptable special characters it can contain are: #, @, $, ?, — (underline), and - 
(hyphen). 


You specify the I/O direction for the field either by accepting the default value 
within the parentheses or by overwriting it with one of the other acceptable values. 
(If you indicate that the field is an INPUT field, the next dialog screen presented is 
dialog screen 2.) 


mw Line 4: 
INTERNAL USAGE IS (1): 1 DISPLAY 2 PACKED 3 BINARY 4 ZONED 


Shows the type of internal usage. The default value for this question is normally 1. 
You should overwrite this value if the usage of the field within your program is 
anything other than display. If you specify one of the other usages for an input 
field, the information entered by the workstation operator is automatically 
converted to that usage. If you specify another usage for an output field, that 
information is automatically converted to display form on output. Usages specified 
for a bidirectional (input/output) field are handled accordingly. 


The default internal usage for a field defined in pass 2 with a sign (+, -, CR, DB) is 
ZONED. A display field can’t represent a signed number (internally). 


m Line 5: 
INTERNAL LENGTH IS: (nn) 
Shows the default internal length calculated by the SFG. The SFG determines 
internal length based on the picture string defined on the type attribute screen (!’s 


and other edit characters used for simple and fixed insertion are not counted) and 
upon the internal usage (packed, binary, zoned, or display) specified. 
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Depending on the internal usage specified and the internal length calculated, the 
SFG may generate one of the three following warning messages. 


SFG40 INTERNAL LENGTH IS LESS THAN DEFAULT FOR USAGE SPECIFIED 


Indicates that the internal length entered for the field is less than it should be 
based on the internal usage specified. 


SFG41 INTERNAL LENGTH IS GREATER THAN DEFAULT FOR USAGE SPECIFIED 


Indicates that the internal length entered is greater than it should be based on 
the internal usage specified. 


SFG42 INTERNAL SIZE MAY BE INVALID. CHECK USER PROGRAM 


Indicates that the internal length entered may be invalid for the internal usage 
specified. If, for instance, a binary field is not specified as one, two, or four 
bytes, this message appears. 


If desired, the internal length and/or the internal usage may be changed, or the 
warning message may be disregarded. To disregard it, place the cursor at the end 
of the dialog screen and transmit. 


In all cases, however, the internal size and usage provided on the dialog screen 
must be compatible with the data structures (data division in COBOL, input and 
output specifications in RPG Il, etc) within the program; otherwise, an error 
condition may result during execution of the program. 


Lines 6 through 9: 


PLEASE INDICATE WHETHER THE FOLLOWING ARE REQUIRED: 1 NO 2 YES 


CONDITIONAL DISPLAY (1) SPECIAL DISPLAY PROPERTIES (1) 
CONDITIONAL RETENTION (1) CONDITIONAL PROTECTION (1) 
RANGE CHECKING (1) 


List the other dialog screens you can select for the field. If you enter 2 (YES) for 
any of the above, the associated dialog screen is displayed after you transmit 


dialog screen 1 (or after you complete and transmit dialog screen 2 if the field is an 
input field). 


Lines 10 and 11 


REPLACE !'S IN THE FOLLOWING LINE BY INSERTION CHARACTERS 
display of the field 


The contents of lines 10 and 11 vary according to the type attributes and 1/O 
direction of the field. If exclamation marks were used to indicate that insertion 
characters were required, then line 10 would display the message shown in Figure 
3—10 (REPLACE !’S IN THE FOLLOWING LINE BY INSERTION CHARACTERS). 
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For example, suppose after pass 2 you had a field defined like this: 
SOCIAL SECURITY: 999!991999 
Lines 10 and 11 of dialog screen 1 for this field would then appear as follows: 


REPLACE !'S IN THE FOLLOWING LINE BY INSERTION CHARACTERS 
9991991999 


You would then overwrite the exclamation marks with a dash: 


REPLACE !'S IN THE FOLLOWING LINE BY INSERTION CHARACTERS 
999-99-999 


The dashes will be protected. They aren’t counted in the internal field length and 
can't be overwritten when the format is being used with a program at run time. 


If dialogs were required for a field requiring protection for edit characters, a 
different message would appear on line 11. For example, if you had a field defined 
as: 


AMOUNT DUE: $99,999.99 
Then lines 10 and 11 would appear as: 


USE A '/' TO MARK PROTECTED EDIT CHARS IN THE FOLLOWING LINE 
$99,999.99 


The only characters you can overwrite are the comma (,) and the decimal point (.). 
(The currency symbol ($) is automatically protected.) Overwriting these characters 
with the slash causes that character to be protected. Protected characters act as 
an edit mask and are not counted in the internal length of the field. 


If you choose to overwrite, the field in this example would appear as $99/999/99. 
When the completed format is displayed on the workstation during its use with a 
program, this field appears as: 

Wes ilies dork ss 
NOTE: 


If you specify protection for a comma in a numeric field, you must also specify 
protection for the decimal point and vice versa. 


Table 3—3 sumarizes how the contents of lines 10 and 11 vary according to the 
way a field is defined. 
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Table 3-3. Contents of Lines 10 and 11 of Dialog Screen 1 


If Field Requesting Dialog Line 10 Reads Line 11 Displays 


Is input, output, or both REPLACE !’S IN THE FOLLOWING The field in 
LINE BY INSERTION CHARACTERS question 


Contains one or more !'s 


Is one of the following 
types: 


Alphabetic (AA!AAA) 
Alphanumeric (AAA!XXX) 
Numeric (999!999) 


ls input or both USE A‘/’TO MARK PROTECTED The field in 
EDIT CHARS IN THE FOLLOWING question 
ls numeric edited: LINE 
$99,999.99 
$9.99 





If the field is other than those described in Table 3-3, nothing appears on lines 10 and 
vA 


NOTE: 


Numeric edited fields containing any acceptable combination of the floating insertion 
sign $, +, or -; the character CR or DB; or the suppression/replacement characters * or 
Z are always output fields and, like all other output fields, are completely protected. It is 
for this reason that you aren't asked to specify any edit characters to be protected. The 
same is true for alphanumeric fields containing B or O. 


Some general rules to keep in mind when completing dialog screen 1 are: 


1. You provide responses for dialog screen 1 by overwriting the default values. If no 
overwriting is done, the defaults are automatically accepted. 


2. Any character other than a slash used to indicate protection for a numeric edited 
(input or bidirectional) field is ignored. 


3. Characters that can be protected in a numeric edited input or bidirectional field are 
the comma and the decimal point. If you specify protection for a comma, you must 
do so for the decimal point and vice versa. 


4. You can’t replace any character other than the exclamation point with an insertion 
character. 


5. The exclamation point itself may be used as an insertion character. 
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3.5.2. Dialog Screen 2 (Input Field Response, Default, and Replenishing) 


Dialog screen 2 lets you indicate the field response, default value, and replenishing value 
for an input field. 


Recall from 3.3.4 that the SFC can erase input from a format so that a workstation 
operator can enter new data. When the input is erased, the area where the input 
appeared is replenished, or replaced, with underlines. Dialog screen 2 provides you 
with the option of choosing a character string other than underlines to replenish an input 
field. You may also indicate how much or how little of the field must be filled in by the 
operator. This is referred to as the field response. You can also specify a default value 
for the field. This value is returned to your program when an operator doesn’t enter 
data in the input field. Figure 3-11 shows the format of a sample dialog screen 2 
display for a field called the SOCIAL SECURITY field. 


1. SOCIAL SECURITY: 999-99-9999 

2. 

3. FIELD RESPONSE (1): 1 OPTIONAL 2 REQUIRED 3 MUST-FILL 4 DEFAULT VALUE IS: 
4. 

5. 

6. 

rae 

8. 

9. 

10. NOTE: FOR DEFAULT, ALPHA CHARACTERS WILL BE PASSED TO PROGRAM IN UPPER OR LOWER 
11. CASE AS ENTERED.FOR REPLENISH, ALPHA CHARACTERS WILL BE DISPLAYED AS ENTERED. 





Figure 3-11. Dialog Screen 2 


The explanations for the lines in Figure 3-11 are: 

m~ Line 1: 
Simply displays the field for which the dialogs are being performed. Note that any 
insertion characters (such as the hyphen) that you supplied in dialog screen 1 are 
shown. 

m= Line 3: 


Permits you to overwrite the default value (1) for the field response with any of the 
other values listed. 


OPTIONAL 
Means that any or no characters may be entered for the field. If no character is 


entered, zero will be assumed for numeric fields and left-justified with blank 
padding for alphabetic and alphanumeric fields. 
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REQUIRED 


Means that at least one character must be entered for the field. The value is 
right-justified with zero padding for numeric fields and left-justified with blank 
padding for alphabetic and alphanumeric fields. 


MUST-FILL 


Means that the field must be completely filled in by the workstation operator. 


DEFAULT VALUE IS 


If no characters are entered for the input field, a value that you supply will be 
used for the program. The value is defined in the following line (4) and is 
right-justified with zero padding for numeric fields and left-justified with blank 
padding for alphabetic and alphanumeric fields. 


gm Line 4 


May only be used if you select DEFAULT VALUE IS for the FIELD RESPONSE. You 
overwrite the underlines with the value that you want used in the program if the 
workstation operator fails to enter anything for that field. As the note at the 
bottom of the dialog screen indicates (Figure 3—11), alphabetic characters will be 
passed to the program exactly as they are entered here (in uppercase or 
lowercase). A numeric value is converted to the appropriate internal usage (display, 
packed, binary, zoned) just as it would be if the workstation operator entered it. 
Under certain circumstances, one of the following messages may be issued for an 
entry on line 4. 


SFG51 DEFAULT VALUE HAS AN INVALID CHARACTER, OR IS WRONG TYPE 


This is displayed if you enter a value that is not compatible with the external 
or the internal usage specified (e.g., the default value contains an alphabetic 
character when the field’s internal usage is specified as packed or binary) or 
one that has an invalid construction (e.g., more that one sign or decimal point, 
no valid numeric digits for a numeric field). You must correct this value to 
continue. 


SFG5@ DEFAULT VALUE IS NON-NUMERIC OR ALL UNDER-LINES (WARNING) 
This is displayed if you enter a nonnumeric value for a field defined externally 
as numeric or numeric-edited and internally as display or zoned. This situation 


is acceptable but it may not be intentional. If the value is correct, the message 


can be ignored. To ignore it, position the cursor to the bottom of the screen 
and then transmit. 


SFG52 DEFAULT VALUE IS TOO LARGE TO BE PROCESSED 
This is displayed if the value you enter for a numeric field is 


1. more than 40 digits for DISPLAY or ZONED internal usage; 
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2. more than 15 digits for PACKED DECIMAL internal usage; or 


3. not within the range -231 < value < (231-1) for BINARY internal usage. 


a Line 7 


Displays what the replenished input field looks like. You can accept the underline as 
the replenishing value or specify another value by overwriting these underlines. 
Alphabetic characters will be displayed on the format exactly as they are entered 
here (in uppercase or lowercase). 


It's important to note that if you specify a replenish character that doesn’t match 
the field's data type (numeric, alphanumeric, alphabetic), it could result in error. If 
the operator completely fills in such a field (thus overwriting the replenish 
character), he can successfully transmit the format. Otherwise, the SFC returns the 
replenish value as part of the data and the illegal characters are rejected. 


In addition, the SFC doesn’t translate underlines (—) that it detects within a 
user-specified replenish value to blanks or zeros. Therefore, you should not specify 
a replenish string that contains an underline for numeric or alphabetic fields. If you 
do and an operator doesn’t key over the underline with a valid character, the SFC 
rejects the field. Be aware, too, that if your field is alphanumeric, the SFC won't 
translate the underline to a blank but it will accept it as input. In this case, it could 
mean returning a meaningless character to your program. 


3.5.3. Dialog Screen 3 (Conditional Field Display) 


Dialog screen 3 is the conditional display dialog. It appears as shown in Figure 3-12. 


display of field 


SPECIFY THE CONDITIONAL INDICATOR WHICH IS TO CONTROL DISPLAY OF FIELD FLDnnnnn 


THE FIRST CHARACTER SHOULD BE '‘Y'' IF DISPLAY IS TO OCCUR WHEN THE INDICATOR 
IS ON OR ''N'' IF DISPLAY IS TO OCCUR WHEN INDICATOR IS OFF. 


F-KEY 13 WILL PROVIDE HELP 





Figure 3-12. Dialog Screen 3 


Conditional display lets you specify an indicator that controls when a field appears at a 
workstation screen. At run time, your program can decide if it needs a particular field 
displayed. If it does, it can turn the display indicator on. If it doesn't, it turns the 
indicator off. (If you use the N nnn indicator syntax, then the opposite is true: display 
occurs when the indicator is off and is suppressed when the indicator is on.) 
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When a field is not displayed, only the display constant (if one is associated with the 
field) appears. (For example, if you had a field like 


SOCIAL SECURITY __.__-____- ae 


only the SOCIAL SECURITY constant appears.) When your program turns the display of 
an input field off, a workstation Operator is unable to enter any data to it. The value 
returned to your program in this case is blanks, zeros, or a default value that you 
specified for the field via dialog screen 2. If you turn off the display of an Output or 
bidirectional field, your program still sends a value for it out to your format, but the SFC 
doesn't display it on the screen. In the case of bidirectional fields, the value your 
program sends to the format is returned to your program as part of the input record. 


If you have an Output field whose value you never want the workstation Operator to 
see, you can unconditionally prevent its display. To do so, use the N 000 syntax for the 
indicator. This hides the Output variable, but saves you the work of rearranging your 
output record. 


NOTE: 


If you initially prevent the display of an input field and then on the next output operation 
Set a retain indicator for it, an operator won't be able to enter data to that field. 





3.5.4. Dialog Screen 4 (Special Field Display) 
Dialog screen 4 is the special display properties dialog. It lets you specify: 
= Default display Properties for a field 


= Conditional display Properties for a field that only take effect when an indicator is 
set 


Instead of only one indicator, however, dialog screen 4 lets you specify as many as 
four indicators, each associated with a different intensity /emphasis combination. In 
addition, each display combination has a different priority level. 


Figure 3-13 shows a display of dialog screen 4. 
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1. display of field 

2. DISPLAY PROPERTIES FOR FIELD FLDnnnnn: INTENSITY: EMPHASIS: 

3. LOWEST PRECEDENCE: I.DEFAULT PROPERTIES (A) 

4. II.OPTION IND (_ ___) (_) 

5. IIT.OPTION IND (_ ___) (_) 

6. IV.OPTION IND (_ ___) (_) 

7. HIGHEST PRECEDENCE:V.OPTION IND (_ ___) : (_) 

8. INTENSITY: EMPHASIS: 

9. A.NORMAL INTENSITY 1.UNDERLINED 4.REVERSE VIDEO 
10. B.ALTERNATE (LOW) INTENSITY 2.COLUMN SEPARATORS 5.BLINK FIELD 
11. C.NOT DISPLAYED 3.STRIKE THRU BARS 6.POSITION CURSOR 
12. E.SAME AS FIELDS IN ERROR 





Figure 3-13. Dialog Screen 4 


When dialog screen 4 first appears, line 3 shows the default display properties that 
have already been assigned for the field. This default can be one of two things: 


1. The value assigned by the SFG 
2. The value you assigned on the special display screen (3.4.4) 


In Figure 3-13, the defaults shown are the SFG defaults for a bidirectional field: 


DISPLAY PROPERTIES FOR FIELD FLDnnnnn: INTENSITY: EMPHASIS: 
LOWEST PRECEDENCE: I. DEFAULT PROPERTIES (A) ¢ ) 


The A refers to the key that appears at the bottom of the dialog screen; it signifies 
normal intensity. Since the emphasis field is left blank, it means there is no special 
emphasis for the field. You can specify a different default for the field by overwriting 
the SFG default with your own choice of display properties. 


Every display combination you specify can have as many as six different types of 
emphasis and one type of intensity. To enter an intensity, refer to the key at the 
bottom of the screen and then enter the letter representing the intensity you want in the 
column marked INTENSITY. You do the same for the emphasis by entering the numbers 
for the different types of emphasis in the field under EMPHASIS. 


On lines 4 through 7, you can specify up to four indicators and corresponding 
intensity/emphasis combinations. At run time, the intensity and emphasis of the field 
depend on which indicator is on. The indicators are assigned priority levels. This way, if 
more than one indicator is on at run time, the one with the highest priority level 
prevails. The default always has the lowest priority, followed by Il OPTION IND on up to 
V OPTION IND, which-has the highest priority level. 


Preceding each indicator number you must supply a Y or N, depending on how you 
want the indicator to trigger a particular display. The (Y — — —) syntax implies that 
when an indicator is on, the field appears with the intensity/emphasis associated with 
it. The (N — — W—) syntax implies that a field appears with a_ particular 
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Lines 8 through 12 list the various intensities and types of emphasis you can choose 
from. Table 3-4 explains each one. 


Table 3-4. Intensity/Emphasis Selections 


Display Property Function/Appearance 


INTENSITY: 
A. NORMAL INTENSITY 
B. ALTERNATE (LOW) INTENSITY 


C. NOT DISPLAYED 


E. SAME AS FIELDS IN ERROR 


EMPHASIS: 


1. UNDERLINED 


2, COLUMN SEPARATORS 
3. STRIKE THRU BARS 

4. REVERSE VIDEO 

5. BLINK FIELD 


6. POSITION CURSOR 


NOTE: 


Fields appear with normal screen intensity. 

Fields appear in low intensity, like display constants. 

Characters keyed in won't appear on the workstation screen. For 
example, if a field was meant for a password, an operator could enter 


the password without the characters actually appearing on the screen. 


A field appears with the same intensity as fields entered in error. This 
intensity is not permitted for output fields. 


The underline is used as a display attribute. This is available only on 
UTS40D (model 2) workstations and applies only to input fields. 


Fields are highlighted with the column separator character ( ). 

Fields appear with strike-thru bars through the characters. 

Characters in a field appear black on a green video background. 

Field is highlighted by blinking. 

You can set up your format (using an indicator) so that the cursor is 
automatically positioned at a particular field. Normally, the cursor is 
positioned at the first input or bidirectional field. If the POSITION CURSOR 
indicator for more than one field is set, the cursor is positioned at the 


first of those fields. You can't specify POSITION CURSOR for output 
fields. 





Not all devices support every display attribute. See Appendix E for a list of what devices support what attributes. 


3.5.5. Dialog Screen 5 (Conditional Field Retention) 





This is the conditional retention dialog screen. It let's you specify an indicator that 
controls when the contents of a field are retained on the workstation screen. When a 
field is retained, only the field's display attributes (intensity and emphasis) are rewritten 
to the workstation screen. Figure 3-14 is a display of dialog screen 5. 


display of field 


SPECIFY THE INDICATOR YOU WISH TO CONTROL DISPLAY RETENTION FOR FLDnnnnn 


CY ) 


(THIS INDICATOR WILL OVERRIDE FORMAT-LEVEL DISPLAY RETENTION FOR THIS FIELD, 
IF SPECIFIED. IF THIS CONDITION IS MET, AN OUTPUT COMMAND WILL AFFECT THE 
DISPLAY ATTRIBUTES ONLY.) 


F-KEY 13 WILL PROVIDE HELP 





Figure 3-14. Dialog Screen 5 
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lf your program sets a retain indicator for an output field, the field retains the value your 
program sent to it. A bidirectional field retains either the value your program supplied or 
the value an operator keyed in over your program value. An input field retains the data 
a workstation operator entered. The value retained in either a bidirectional or input field 
is the value that is ultimately returned to your program. 


Since the retain operation allows the SFC to rewrite the field display attributes, you can 
highlight any field you retain. For example, when your program sets a field retain 
indicator, it can also set a special display indicator from dialog screen 4. 


The retain option can also be specified at the format-level (3.4.6). However, the 
field-level retain indicator you specify on dialog screen 5 overrides the format-ilevel 
retain indicator. 


If you use the (Y — — —,) indicator syntax, the contents of a field are retained on the 
workstation screen when the indicator is on. If you use the (N — — —,) indicator 
syntax, the field is retained only when the indicator is off. (Use of the unconditional 
syntax is permitted, but not recommended.) 


NOTE: 


When a format is initially written to a screen, any retain indicators are ignored. 


3.5.6. Dialog Screen 6 (Conditional Field Protection) 


Dialog screen 6 is the conditional protection dialog. Conditional protection prevents an 
operator from entering data in an input or bidirectional field, if a protection indicator is 
set. 


When a protection indicator is set, a workstation operator is unable to position the 
cursor at that field. The cursor simply skips over it. You control protection via the 
indicator you enter on dialog screen 6, shown in Figure 3-15. 


display of field 


SPECIFY THE INDICATOR YOU WISH TO CONTROL PROTECTION OF FIELD FLDnnnnn 
CY ___) 


IF THE FIRST CHARACTER IS ''Y'', THE FIELD WILL BE PROTECTED WHEN THE INDICATOR 
TS ON. IF ''N'!' IS SPECIFIED, PROTECTION OCCURS WHEN THE INDICATOR IS OFF. 


F-KEY 13 WILL PROVIDE HELP 





Figure 3-15. Dialog Screen 6 


You can use the Y — — — indicator syntax where a field is protected when the 
indicator is on; or you can use the N — — ~— indicator syntax where the field is 
protected when the indicator is off. (Use of the Y OOO unconditional syntax is 
permitted, but not the unconditional N OOO syntax.) 
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A protected bidirectional field returns either a program-supplied or user-supplied value 
to your program. A protected input field returns blanks, zeros, or a default constant 
(supplied on dialog screen 2). If your program sets both a retain and a protection 
indicator on, the value returned to your program is the retained value. 


NOTES: 


1. If you set a protection indicator on when a format is first displayed and on a 
subsequent output operation you reset the protection indicator, an SFO8 error 
message is displayed. 


2. On UNISCOPE 100/200 devices, a field can’t be conditionally protected and 
retained. 


3.5.7. Dialog Screen 7 (Input Field Range Checking) 
Dialog screen 7 lets you set range check values for input and bidirectional fields. Figure 


3-16 shows a dialog screen 7 display for a sample field called the SOCIAL SECURITY 
FIELD. 


1. SOCIAL SECURITY: 999-99-9999 

2. 

3. SPECIFY THE TYPE OF CHECK AND RANGE VALUE(S) FOR FIELD FLDO0000: 
4. 

5. RANGE CHECK (1): 1 BETWEEN 2 LESS THAN 3 GREATER THAN 4 EQUAL 
6. > NOT EQUAL 6 LESS/EQUAL 7 GREATER/EQUAL 

7. RANGE VALUE(S): 

8. 

9. 

10. 

11. MORE? (1): 1NO 2 YES 





Figure 3-16. Dialog Screen 7 


Range checking simply means that data an operator enters in an input or bidirectional 
field is checked to see if it is within range (between, greater than, less than, etc) of a 
set of values that you specify. You can specify range checking for numeric, 
alphanumeric, and alphabetic fields. The range check values themselves can be numeric 
or alphabetic. You select the type of range check on line 5 and supply the range value 
on line 8 (and line 9 if you specified BETWEEN). 


NOTE: 


For BETWEEN range checks, you must enter two values, and the first value must be 
less than the second value. 
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The field in our example is a numeric input field defined as 999-99-9999. If BETWEEN 
is specified, the input value must either fall between the two values or be equal to one 
of the two values that you supply (overwrite) on lines 8 and 9. 


You select 1 BETWEEN on line 5. 
You supply RANGE VALUES = 195-44-8867 on lines 8 and 9. 
295-67-3563 


if you choose any of the other range checks, only line 8 should be overwritten with a 
value. 


You select LESS/EQUAL on line 5. 
You supply 195-44-8867 on line 8. 


You can specify, in any combination, a maximum of 10 range checks for one field by 
overwriting the default value on line 11 with the value 2 (YES). Upon transmission, the 
screen is displayed again for the same field. You may then select another range check 
and supply the corresponding value. 


When multiple range checks are requested, the SFG automatically performs an OR 
operation, which logically unites the combinations for you. Suppose you select 3 
(GREATER THAN) and 5 (NOT EQUAL) as the range checks for a field. The run-time 
value for that field is checked, ensuring that it is either greater than or not equal to the 
range values you specified on line 8. 


An error condition is indicated at run time if the value for a field doesn’t pass the range 
check specified. You may make provisions within your program in the event that a 
workstation operator is unable to correct the error. Range checking is suppressed under 
the following conditions: 


m An operator doesn’t enter data in a field. (Even though the input value returned to 
your program in this case is zero or blanks and thus might not meet the range 
check values specified, they aren't checked.) 


= An operator doesn't enter data in an input field that has a default value. The 
default value isn't checked. 


s Data that your program sends out to a bidirectional field isn't checked. 


The SFC performs range checking only after it completes other lower-level validation of 
input. For example, if an operator enters numeric data in an alphabetic field, the SFC 
detects the error before it subjects the data to a range check. 


NOTE: 


Lowercase to uppercase translation occurs before range checking is applied. Therefore, 
if you enter alphabetic range values on dialog screen 7 in lowercase and you specified 
lower to uppercase translation on the characteristics screen, the data an operator enters 
always fails. 
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When you transmit dialog screen 7 after specifying the tenth range check or after 





answering 1 (NO) to the question on line 11, dialog screen 1 is automatically 
redisplayed for the next field requesting dialogs. If, however, no other fields request 
dialog, the home screen is automatically presented for you to select another function. 
The creation of the format is complete. 


3.5.8. Default Values for Dialog Screens 


If dialogs aren't requested, certain default characteristics are automatically assumed for 
the field. These defaults are: 


= =§=For numeric and numeric-edited fields 


1. 


2. 


10. 


11. 


12. 


13. 


Field 1D: SFG-provided ID is accepted. 
Insertion characters: None 


Protected edit characters: None 


Internal usage: Display (zoned for those fields defined with a sign (+, 


DB) on the type attribute screen) 

Internal length: SFG-computed length is accepted. 
Range checking: None 

Conditional display: No (Field always appears.) 
Conditional retention: No 

Special display properties: No 

Conditional protection: No 

Replenishing value for | or B fields: Underlines 
Field response: OPTIONAL (zero for numeric fields) 


Fields are right-justified with zero padding. 


m= §=6For alphabetic and alphanumeric edited or nonedited fields 


te 


2. 


ha CR, 





Defaults 1 - 11 for numeric fields apply to alphabetic and alphanumeric fields. 


Field response: OPTIONAL (blanks) 


Fields are left-justified with blank padding. 
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3.6. COMPLETING SFG SCREENS — CURSOR POSITIONING AND 
OVERWRITING 


As soon as the SFG is activated, you get a workstation display of the home screen: 


1. FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

2. 5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 

3. OLD FORMAT NAME (¢ ) IS ON THE FOLLOWING LIBRARY: 

4. FILE NAME: (SYSFMT ) VOLUME: (RES 

5. 

6. NEW FORMAT NAME ( ) IS TO BE STORED ON THE FOLLOWING LIBRARY: 

7. FILE NAME: ($YSFMT ) VOLUME: (RES ) 
8. IF THIS FILE DOES NOT EXIST, ALLOCATE (002) CYLINDERS. INCREMENT IS (@1) CYL. 
9. 

10. **FUNCTION KEYS ARE:F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, 

11. F13-HELP, F14-EXIT HELP, F2@-RESTORE SCREEN 





In general, the unprotected value appearing within parentheses following any question is 
the default value (response) for that question. For example, on lines 4 and 7 of the 
home screen, the default for FILE NAME is $Y$FMT. You can either accept that default 
or overwrite it with another acceptable value. 


When overwriting, you must first position the cursor over the default value. When the 
home screen is initially presented, the cursor appears in the upper left-hand corner of 
the screen. You can control its movement by using the following keys: 


Cursor to HOME key 
Cursor scan keys 
Tab FWD or tab back keys 


The results produced by using any of these keys are essentially the same. The cursor 
moves, but automatically stops and positions itself over the first default value. Refer to 
the interactive services command and facilities user guide/programmer reference for the 
specifics concerning control of the cursor’s movement. 


You can enter another acceptable value in the parentheses or keep the default value and 
simply move the cursor to another position. Keep in mind that the action of overwriting 
causes the cursor to move automatically to the next unprotected character. 


NOTE: 


In this manual, sample user entries on SFG screens are shown in reverse lettering (white 
characters on black background): 
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Once the home screen is completed, you transmit it by pressing the XMIT key. If, for 
example, the function you chose on line 1 was CREATE, the characteristics screen is 
the next screen that appears: 


1. GLOBAL CHARACTERISTICS FOR FORMAT nnnnnnnn 

2. LOWER CASE TRANSLATION? (1): 1 YES 2 NO 

3. ALPHABET: (ENGLISH_) SCREEN FORMAT IS (1): 1 ORIGINAL 2 OVERLAY 

4. ERASE/UNLOCK OPTION (1): 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
5. 4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 
6. ERROR RETRY COUNT: (02) SPECIAL EDITING CHARACTERS? (1): 1NO 2 YES 
7. SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 

8. DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (1): 1 NO 2 YES 

9. DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 

10. FUNCTION OR COMMAND KEYS TO BE DEFINED? (1): 1 NO 2 YES 

11. DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1NO 2 YES 





The rules for positioning the cursor on the home screen also apply to the characteristics 
screen. You can transmit the characteristics screen whenever you finish all the 
necessary overwriting. For example, if you only want to change a value on line 4, 


ERASE/UNLOCK OPTION ® > 1NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 


you may transmit the characteristics screen immediately after you overwrite the 1 on 
that line. The default values for the following lines are automatically accepted. If you 
change all these values, the cursor must be at the bottom of the home screen before 
transmission. Remember, if you don’t change any of the values, you simply transmit the 
characteristics screen after it appears. 


If you make mistakes while completing any SFG screen, transmission doesn’t occur. In 
general, the screen is redisplayed and any errors are highlighted. 


NOTE: 


If you overwrite any of the values on a screen, before transmitting make sure that you 
position the cursor past the last default value you overwrote on the screen. 


These general rules for completing the home screen and characteristics screen apply to 
other SFG displays, such as optional and dialog screens. 


If you have difficulty completing a screen at any point, you can initiate the HELP 
function (3.8) 


For more information concerning workstation operation, refer to the interactive services 
commands and facilities user guide/programmer reference. 
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3.7. ERROR AND WARNING MESSAGES 


There are certain instances when an entry on the home screen may be syntactically 
correct but violates an SFG logical rule. In these instances, blinking does not occur. 
Instead, one of the following messages is displayed on the workstation screen. 


SFG20 OLD FORMAT —__— _ __ __ _._ DOES NOT EXIST. 


The format specified as OLD FORMAT cannot be found. You should check to see if 
the spelling of the format’s name is correct, or you might check the contents of the 
format library (SYS$FMT or a user-assigned library), via the librarian or the FSTATUS 
system command, to see if that format actually exists. 


SFG11 FORMAT — — _$ — _ _ IS LARGER THAN CURRENT SCREEN. 


This message indicates the format is larger than the screen size. For example, a 
format of 24 lines cannot be displayed and consequently cannot be modified on a 
workstation screen with a 12-line capacity. 


These messages (SFG20 and SFG11) require corrective action. You must enter another 
format name before you can transmit the home screen. Messages SFG21 and SFG23 
are only warning messages. Corrective action may be taken; however, no action is 
required. 


SFG21 NEW FORMAT __ _—$ _ _. _._ _ ALREADY EXISTS. TO REPLACE, TRANSMIT. 


This message indicates that the current format name is the same as an existing 
format name. If you don’t want the old format name replaced, change the name of 
the new format. If you do want the old format replaced, position the cursor to the 
end of the format and transmit. 


SFG22 FC TYPE ELEMENT NOT FOUND FOR FORMAT _._ — ese 


This message indicates the format element type ‘‘F’’ exists but the ‘FC’ type does 
not exist. Use the MODIFY option to create your new format using the old format 
name. 


SFG23 (WARNING) _______~_ LANGUAGE TABLE NOT FOUND IN FRMTOUT. 


This message indicates that a language other than English was specified on the 
home screen and that the output file into which the SFG is to write the format does 
not have a character set translation for that language. 


Again, this is a warning message only. You may go ahead and build the format (by 
positioning the cursor to the bottom of the screen and transmitting); however, note 
that a translation table must be supplied for the file before the SFC can use the 
format. 
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a SFG9@ FUNCTION IS NOT SUPPORTED 


This message indicates the function requested on the home screen, the function 
key, or some other specification requests a nonexistent function or feature. Correct 
and rerun. 


The system messages programmer/operator reference lists these messages, as well as 
other error messages you may get while using the SFG or the SFC. 


3.8. THE HELP FUNCTION 


In 1.3, we mentioned that an ease-of-use feature accompanying the SFG is its capability 
to provide prompting for any procedure with which you might be having difficulty. This 
capability is the HELP function. 


You may request help once the home screen is displayed and anytime during the SFG 
session simply by pressing the function shift key in combination with the F13 function 
key. You then get the appropriate screen that tells you how to complete the operation 
for which help was requested. You can return to the point in the SFG session where 
you originally left off by using the F14 function key. 


Let's say that you’ve been presented with the home screen and selected the CREATE 
function, but you’re not quite sure about completing the rest of the screen. If you 
request help, the appropriate set of instructions for completing the home screen will be 
displayed. 


The HELP function can be initiated in this manner at any point in the SFG session. 
Whether you're in the middle of creating a format or modifying one, you can ask the 
SFG for help whenever it’s necessary. Appendix B contains examples of the various 
help screens. 
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4. Creating Screen Formats 


4.1. CREATING A SIMPLE SCREEN FORMAT 


A simple format is one where all the SFG defaults are accepted and no optional or 
dialog screens are required. Such a format is included here to demonstrate the basic 
steps needed to create a usable screen format. Once you're familiar with this procedure, 
it will be easier to go on to the discussion of more complex formats later in this 
section. 


Table 4-1 shows the sequence of steps involved in creating a simple format. 


Table 4-1. Basic CREATE Function Steps 


a 
Activates the SFG and displays the 
home screen 


11. Complete pass 2 - type attribute 
screen. 


























Provides name of format and where 
it will be stored 












Provides actual format layout with 
display constants and variable 
data field representation 













Provides type attributes and 
editing for variable data 










12. Press XMIT key. 


13. Complete pass 3 ~ I/O screen 
14. Press XMIT key. 


15. Terminate (enter 8 on line 1 of) Terminates the SFG session 
the resulting home screen. 












Indicates direction of data flow 
between the program and the format 
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Recall from Section 3 that the home screen appears after you activate the SFG. You 





complete the home screen as follows: 


Accept the default value (1) CREATE for the function on line 1. 
Provide a name for your format on line 6. 
Accept the defaults for the library on line 7. 


Transmit the home screen. 


As an example, suppose you were creating a format called MYSCREEN. After you 
complete the home screen, but before you transmit it, it should look like this: 


~~ SP DOAN OV FWP = 


- S&S 


FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 
OLD FORMAT NAME ( ) IS ON THE FOLLOWING LIBRARY: 
FILE NAME: (S$YSFMT ) VOLUME: (RES 


NEW FORMAT NAME 1S TO BC STORED ON THE FOLLOWING LIBRARY: 
FILE NAME: ($Y$FMT ) VOLUME: (RES ) 
IF THIS FILE DOES NOT EXIST, ALLOCATE (002) CYLINDERS. INCREMENT IS (01) CYL. 





**FUNCTION KEYS ARE:F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, 
F13-HELP, F14-EXIT HELP, F20-RESTORE SCREEN 





After you transmit the home screen, the characteristics screen is automatically 
displayed: 


P RP OMAN OU RW = 


= ©: 


GLOBAL CHARACTERISTICS FOR FORMAT MYSCREEN: 

LOWER CASE TRANSLATION? (1): 1 YES 2 NO 

ALPHABET: (ENGLISH_) SCREEN FORMAT IS (1): 1 ORIGINAL 2 OVERLAY 

ERASE/UNLOCK OPTION (1): 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 


ERROR RETRY COUNT: (02) SPECIAL EDITING CHARACTERS? (1): 1 NO 2 YES 
SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 

DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (1): 1 NO 2 YES 
DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 

FUNCTION OR COMMAND KEYS TO BE DEFINED? (1): 1 NO 2 YES 

DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1 NO 2 YES 
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Since this is a basic format, you accept all the defaults by simply transmitting the 
screen. 


This gives your format the following characteristics: 
m Lowercase translation is used. 

# # English alphabet is used. 

m= The format is an original format, not an overlay. 
m Erase/unlock option is NONE. 

m= The error retry count is 2. 


= Your format will not use special editing characters, special display controj, or an 
error message field. 


= Your format will not retain the contents of variable data fields on the workstation 
screen. 


m Your format will not use function keys, nor will it have a nondisplayed field. 


After you transmit the characteristics screen, you're presented with a blank workstation 
screen to key in the format layout. This step is called pass 1. 


4.1.1. Pass 1 — Providing the Layout 


When the blank screen is presented, you simply lay out your format by positioning the 
cursor to points on the screen that you choose and by keying in any display constants 
and underlines representing the external length of the variable data fields. The number 
of lines that a format can contain, as well as the maximum length of its longest line, is 
limited to the physical size of the workstation screen. Also, the length of a variable data 
field is limited to the length of one line. Continuation of a variable data field on the 
following line is not permitted. 


Figure 4-1 illustrates what a completed template screen might look like: 


STUDENT GRADE REPORT 


NAME: 


SECTION: ___ 
INSTRUCTOR: 
FINAL COURSE GRADE: _ 


Nauk WNN = 





Figure 4-1. Typical Template (Pass 1) Screen 
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This screen can be analyzed as follows: 


Line 1 


Contains three display constants and two variable data fields. The display 
constants are STUDENT GRADE REPORT, the slash (/), and the /82. Both data 
fields are represented by two underlines (__ _), indicating an external length of two 


character positions. 


Line 2 


Contains one display constant and one field. The display constant is NAME:, and 
the field is represented by 30 consecutive underlines. 


Line 3 


Contains one display constant (STUDENT NUMBER) and one variable data field (five 
underlines). 


Line 4 


Contains two display constants (COURSE NUMBER: and one hyphen) and two fields 
(two and four consecutive underlines, respectively). 


Line 5 


Contains one display constant (SECTION:) and one field (three consecutive 
underlines). 


Line 6 


Contains one display constant (INSTRUCTOR:) and one field (30 consecutive 
underlines). 


Line 7 


Contains one display constant (FINAL COURSE GRADE:) and one field (one 
underline). 


Although completion of pass 1 is simple, there are some general notes to keep in mind. 


1. 


2: 


3. 


The external length of a variable data field is always expressed by consecutive 
underlines. 


Any character other than an underline is considered a display constant. 


Display constants are always protected. 
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Display constants will appear on the completed format exactly the way you enter 
them. Thus, lowercase display constants remain in lowercase and uppercase 
display constants remain in uppercase. This doesn’t apply to Katakana characters. 
If you specify at least one display constant but no variable data fields, the format’s 
creation is complete as soon as you transmit the template screen. After 
transmission, the home screen appears again for you to select another function. 


If you specify at least one variable data field and press the XMIT key, that field is 
redisplayed for you to complete pass 2. 


You can use the F13 function key to initiate the HELP function at any point during 
the completion of pass 1. 


You can terminate pass 1 at any point by pressing the function shift in combination 
with the F1 key. No format is created, and the home screen is displayed for you to 
select another function. 


The cursor must be at the end of the screen format you're defining before you 
press the XMIT key. 


If you press XMIT before moving the cursor (before making any entries on the 
blank screen), the following message appears: 


SFG12 NO DATA ENTERED — POSITION CURSOR TO END OF SCREEN, XMIT 


If this happens, simply make the desired entries and transmit. 
The limit for the number of variable data fields on a screen format is 255. If a 
greater number of variables (group of underscores) is entered, or if the format 
specified is too large for the generator to handle for any reason, the following 
message is displayed: 

SFG1@ NO. OF VARIABLES OR CHARACTERS IN FORMAT IS TOO LARGE. 
Processing returns to the home screen. 


If you press function key 20 during this pass, the following message appears: 


SFG9® FUNCTION NOT SUPPORTED 


4.1.2. Pass 2 — Specifying Type Attributes and Editing 


When you transmit the finished template screen, it is automatically redisplayed for you 
to specify the type attributes and edit characters for all the variable data fields. The 
type attributes specified indicate the kind of data (numeric, alphanumeric, alphabetic) 
this field will receive when the format is being used to input and output data. Basically, 
you use COBOL-like picture clauses to define field type attributes and editing characters. 
Refer to Section 2 for rules governing type attributes and editing. Figure 4-2 illustrates 
what a completed type attribute screen looks like. 
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99/99/82 





STUDENT GRADE REPORT 
STUDENT NUMBER: 99999 
COURSE NUMBER: XX-9999 

SECTION: 999 

INSTRUCTOR: A 
FINAL COURSE GRADE: 











Nou WN 


Figure 4-2. Typical Type Attribute (Pass 2) Screen 


This screen can be analyzed as follows: 
= Line 1 

Contains two fields that are defined as numeric: 99 and 99. 
a Line 2 


Contains one alphabetic field. The A in the first position indicates that the entire 
field is alphabetic. : 


ws Line 3 





Contains one numeric field (99999). 
a Line 4 

Contains one alphanumeric field (XX) and one numeric field (9999). 
m Line 5 

Contains one numeric field (999). 
w Line 6 


Contains one alphabetic field. The A in the first position indicates that the entire 
field is alphabetic. 


r Line 7 
Contains one alphabetic field (A). 
Some rules that apply to the completion of the type attribute screen are: 


1. The last type attribute character specified for a field is assumed for the rest of that 
field. For example, AL — — — — denotes an entire alphabetic field. 





2. An exclamation point (!) may be used in alphabetic, alphanumeric, and numeric 
fields to indicate that an insertion character is required. The exclamation point may 
not be used if any other edit characters are specified. 
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3. If you specified one or more special edit characters for numeric-edited fields, via 
the edit screen, you must use these characters on the type attribute screen. The 
edit screen is discussed in 3.4.3. 


4. A numeric-edited field that contains any acceptable combination of the floating sign 
$, +, or -; the character CR or DB; or the suppression/replacement character * or 
Z is considered as an output-only field by the SFG. It is always protected and is 
used only to display output data on the format at run time. 


5. The preceding rule also applies to alphanumeric fields containing the edit character 
B or zero (0). 


6. You can initiate the HELP function at any time during pass 2. See Appendix B for 
the pass 2 help screen. 


7. You can terminate pass 2 at any point by pressing the function shift key and the 
F1 function key. All entries for the type attribute screen and the preceding template 
screen are ignored, and no screen format is created. The home screen is 
automatically displayed for you to select another function. 


8. If there are any errors on the type attribute screen, it will be redisplayed when you 
press the XMIT key, and the errors will be blinked. 


9. Errors must be corrected before transmission of the screen can occur. 
10. The cursor must be beyond the last character before you press the XMIT key. 


After you transmit the type attribute screen, you are ready to proceed to pass 3. 


4.1.3. Pass 3 — Specifying |/O Directions and Initiating Dialogs 


When you transmit the type attribute screen, the template screen is displayed for you 
to specify the input and output directions for each field in the format. (This is also the 
step where you initiate dialog screens if they’re required.) Figure 4-3 shows a typical 
initial 1/O screen display. 


STUDENT GRADE REPORT 0_/0_/82 


STUDENT NUMBER: 0 


COURSE NUMBER: 0 _-O ___ 
SECTION: O __ 


INSTRUCTOR: O 
FINAL COURSE GRADE: 0 





Figure 4-3. Typical Initial [/O (Pass 3) Screen 


cmc nner caaaataasaaaacaasacaaaaaaaasaaaaacamaaaaaacaaaaaaaasamaaaaaamaaaaasaadaaaaaaaaaaaaaasaaaaaaaaamauacaaaaaamsaiaaaasaaaasaaasasamasdmsaasaaeasams sass 
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The only difference between this and the template screen is that the letter O is 
displayed in the first position of each field. 


The letter O signifies that the default I/O direction for the fields is output. You can 
overwrite this default with either an | for input or a B for both input and output, 
depending, of course, on the specific application of the format in a program. If you 
want to accept all of the defaults, simply transmit the I/O screen. 


The effects of these |/O directions on the fields of the format are: 


O - For Output 


Indicates that the field will only be used to display variable data from a program at 
run time. Any data displayed in an output field is always protected and cannot be 
altered until new output data from you program overwrites it or until the entire 
format is erased. 


| - For Input 


Indicates that the field will only be used for variable data entered by the 
workstation operator. This input will be passed to the program at run time. Input 
fields are unprotected (except possibly for certain edit characters). 


B - For Both (input and output, or bidirectional, fields) 


Indicates that the field will be used to display variable output or to enter variable 
input. Bidirectional fields are also unprotected. A bidirectional field is always 
expected to display output the first time the format from your program is displayed 
at the workstation (see 1.3.2.2). 


Some general rules pertaining to the completion of the |/O screen are: 


1. 


A numeric-edited field that contains any acceptable combination of the floating sign 
$, +, or -; the character CR or DB; or the suppression/replacement character * or 
Z is considered a protected output field. Therefore, any numeric-edited field that 
was represented in this manner in pass 2 must be defined as an output field in 
pass 3. Specifying anything other than an O (for output), an exclamation point (for 
dialogs), or an underline (for dialogs) results in an error condition (blinking). 


The preceding rule applies to alphanumeric fields containing the characters B or O 
(zero). 


You can initiate the HELP function at any time during the completion of pass 3. See 
Appendix B for the pass 3 help screen. 


You can terminate the I/O screen at any time by pressing the F1 function key. All 
entries for this and preceding passes are ignored, and no screen format is created. 
The home screen is automatically displayed for you to select another function. 


If there are any errors in the 1/O screen when you press the XMIT key, the screen 
is redisplayed, and the errors are blinked. 
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Any errors must be corrected before transmission of the screen can occur. 


The cursor must be positioned after the last specification entered on the |/O screen 
before you press XMIT. 


If dialogs are not requested, format generation is complete. The format is stored on 
the library specified on the home screen, and the home screen is redisplayed. 


In many cases, completion of the I/O screen is the last step in creating a format. Using 
our simple example, we can review all three passes. 


Pass 1: You provide the format layout and transmit. 


STUDENT GRADE REPORT 


SECTION: ___ 
INSTRUCTOR: 
FINAL COURSE GRADE: _ 





& m= Pass 2: You specify type attributes and editing and then transmit. 


STUDENT GRADE REPORT 99/99/82 
NAME:A 
STUDENT NUMBER: 99999 
COURSE NUMBER: XX-9999 


SECTION: 999 
INSTRUCTOR: A 
FINAL COURSE GRADE: 





Pass 3: You specify input/output directions and transmit. For the example format, 
suppose all the fields are input fields. Pass 3 would look like this: 








STUDENT GRADE REPORT 
STUDENT NUMBER: 
COURSE NUMBER: 
SECTION: I __ 
INSTRUCTOR! I.) 
FINAL COURSE GRADE: 












When the I/O screen is transmitted, the format is complete and the home screen is 
redisplayed for you to choose another function. 
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4.2. CREATING MORE COMPLEX FORMATS (USING OPTIONAL AND 
DIALOG SCREENS) 


The format created in 4.1 is a basic format. It doesn't require additional controls over 
any run-time characteristics, nor does it contain any edited fields. Not all formats are 
that simple, however. Many formats do require edited fields and are more effective 
when certain features of the format are altered. This subsection illustrates how formats 
are created with dialog and optional screens. These additional screens provide more 
stringent controls over a format’s run-time features. 


4.2.1. A Sample Format 


Suppose you needed a format for a program that gathers information on purchase 
orders. The purchase orders are from companies that regularly place an order every 
month. Though the companies are the same every month, the items they order and 
their quantities do vary. 


The user program is to display a format, outputting the name and address of the 
company placing an order. The order entry clerk enters the date of the order, the item 
name, quantity, stock number, price, and the date required. These are the format’s 
input fields. 


The program must ensure that the stock number is a valid one. If valid, the ordering 
* information from the input fields is passed back to the program and added to a file. The 
input fields are then replenished to permit entry of the next order date, item, stock 
number, etc, for that company. If the stock number is invalid, the program blinks the 
number and outputs an error message to the format. 


When the order entry clerk has entered all the items for a particular company, he enters 
an item name of all zeros (0). This directs the program to display the name and address 
of the next company in the file. 


To meet all these specifications, the format requires these optional screens: 


= The conditional erase/replenish screen. A conditional indicator supplied on this 
screen controls when the format’s input fields are replenished. Remember that if 
one customer orders more than one item, only the input-only fields are replenished, 
not the output fields that contain the customer name and address. 


mw The error message screen. The format needs an error message field to notify the 
order entry clerk that he has entered an invalid stock number. 
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@r.- dialog screens needed and the fields that need them are: 


m= STOCK NUMBER 
Dialog Screen 1 
Always the first dialog screen presented. Needed to prompt subsequent 
dialogs, specify field direction, and provide information about the field’s internal 
usage. 
Dialog Screen 2 
Always presented for input fields that require dialogs. Needed to specify 
operator response and any replenishing or default values. 
Dialog Screen 4 
Needed to specify special display control for this field. When an order entry 
clerk enters an invalid stock number, the field blinks. 

m UNIT PRICE 


Dialog Screen 1 


This dialog is especially important for the UNIT PRICE field, because it will be 
an edited field. In addition to the functions noted for the STOCK NUMBER, this 
dialog also lets you specify protection for a decimal point and comma 


associated with this field. 
- Dialog Screen 2 
Serves the same function as dialog screen 2 for STOCK NUMBER. 


The steps needed to create the format described are summarized in Table 4-2. 


Table 4-2. CREATE Function Steps Using Optional and Dialog Screens (Part 1 of 2) 





Activates the SFG and displays the 
home screen. 











Provides information about where 
the format will be stored 
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Table 4-2. CREATE Function Steps Using Optional and Dialog Screens (Part 2 of 2) 


8. Complete characteristics screen 
9. Press XMIT key. 


10. Optional: Complete any optional screens. 





Provides information related to format 
as a whole; prompts optional screens 





















Provides more detailed information about 
format as a whole 





























11. Press XMIT key. 


: 


20. Terminate (enter 8 on line 1) the 
resulting home screen if no 
further functions are required. 


Provides actual format layout with display 
constants and variable data field 
representation 


Provides type attributes and editing for 


variable data 


Indicates direction of data flow between 
the program and the format. May initiate 
dialog screens for one or more fields 


Provides further information about 
specific fields 


Terminates the SFG session 





4.2.1.1. The Sample Home Screen and Characteristics Screen 


After you activate the SFG, the home screen is displayed for you to choose a function, 
name your format, and indicate its library. The completed home screen for the example 
format is: 


FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 
OLD FORMAT NAME (¢ ) IS ON THE FOLLOWING LIBRARY: 
FILE NAME: ($YSFMT ) VOLUME: (RES 


NEW FORMAT NAME (QQQSORQENI) IS TO BE STORED ON THE FOLLOWING LIBRARY: 


FILE NAME: (ya@pgaS ) VOLUME: ((a » 
IF THIS FILE DOES NOT EXIST, ALLOCATE ¢ ) CYLINDERS. INCREMENT IS (@1) CYL. 


**FUNCTION KEYS ARE:F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, 
F13-HELP, F14-EXIT HELP, F2@-RESTORE SCREEN 


Pp SH VDAN A VF WN = 


- 6: 
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On line 1, you accept the default (1 CREATE). The format name (MYFORMAT) is 
supplied on line 6. This format won't be stored on the $Y$FMT file, however. Instead, 
it will be stored in the file MYFILE on the volume MYVOL1, as shown on line 7. Since 
space for MYFILE was not previously allocated, five cylinders are specified on line 8, 
and the INCREMENT default of 1 is accepted. 


Once you transmit the home screen, the characteristics screen appears. It is completed 
as shown: 


1. GLOBAL CHARACTERISTICS FOR FORMAT MYFORMAT 

2. LOWER CASE TRANSLATION? (1): 1 YES 2 NO 

3. ALPHABET: (CENGLISH_) SCREEN FORMAT IS (1): 1 ORIGINAL 2 OVERLAY 
4. ERASE/UNLOCK OPTION (ep: 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
5. 4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 
6. ERROR RETRY COUNT: (@2) SPECIAL EDITING CHARACTERS? (1): 1 NO 2 YES 
7. SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 

8. DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (Bb: 1 NO 2 YES 

9. DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 

10. FUNCTION OR COMMAND KEYS TO BE DEFINED? (1): 1NO 2 YES 

11. DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1NO 2 YES 





All the SFG defaults are accepted with two exceptions: 
m Erase/unlock is by CONDITIONAL INDICATOR (line 4) 
m An error message field is requested on line 8. 


By specifying CONDITIONAL INDICATOR for the ERASE/UNLOCK option (line 4), you 
prompt the display of the conditional erase/replenish screen. Similarly, by responding 
with 2 for YES on line 8, you prompt the error message screen. 


After you transmit the characteristics screen, the conditional erase/replenish screen is 
the first of the optional screens to appear. 


4.2.1.2. The Conditional Erase/Replenish Screen for MYFORMAT 


Recall from 3.4.2 that you can specify a conditional indicator that controls when input 
fields are replenished. For the sample format, you want input fields replenished after an 
order entry clerk has filled them in. To this condition, suppose you assign an indicator 
number of 1. When you complete the conditional erase/replenish screen, it should 
appear as: 








ENTER THE CONDITIONAL ACTION DESIRED AFTER INPUT FOR FORMAT MYFORMAT 





DO YOU WISH ALL INPUT-ONLY FIELDS TO BE REPLENISHED AFTER INPUT 
BASED UPON A CONDITIONAL INDICATOR? (BD: 1.NO 2 YES’ INDICATOR CY ) 












DO YOU WISH TO HAVE THE SCREEN ERASED AFTER INPUT 
BASED UPON A CONDITIONAL INDICATOR? (1): 1 NO 2 YES INDICATOR CY ___ 


NO uw kPWD = 
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4.2.1.3. The Error Message Screen for MYFORMAT 


After you transmit the conditional erase/replenish screen, the error message screen 
automatically appears. (For a complete discussion of the error message screen, see 
3.4.5.) To meet the needs of the sample format, you complete the error message as 
shown here: 


1. ENTER THE FOLLOWING INFORMATION FOR YOUR ERROR MESSAGE FOR FORMAT MYFORMAT 
2. MESSAGE FIELD NAME IS: CERRORMSG) 

3. NUMBER OF LINES IN ERROR MESSAGE: (1) ENTER 1 OR 2 

4. DISPLAY ERROR MESSAGE ON LINE NUMBER: (LAST) ENTER NUMBER OR 'LAST' 
5. ERROR MESSAGES CONDITIONALLY DISPLAYED: INDICATOR (Y B__) 

6. DISPLAY ATTRIBUTES: INTENSITY: (A) EMPHASIS: (4 ____) 

7. 

8. INTENSITY: EMPHASIS: 

9. NORMAL INTENSITY .» UNDERLINED 4. REVERSE VIDEO 
10. ALTERNATE (LOW) INTENSITY - COLUMN SEPARATORS 5. BLINK FIELD 
11. STRIKE THRU BARS 





The name of the error message field is ERRORMSG (the default). The number of lines 

for the message is 1 and when it appears, it is displayed on the last line of the format. 

The indicator number specified is 2. Therefore, when that indicator is on, the error 

message is displayed. (Note that the actual contents of the error message must be @ 
defined in your program.) When the error message appears, it is displayed in reverse 

video. 


Once you complete and transmit the error message screen, you're ready to lay the 
format out. 


4.2.1.4. Completing Pass 1 for MYFORMAT 


The rules concerning the layout (pass 1) of the sample format are the same as those 
discussed in 4.1.1 for the simple format. You simply key in the display constants and 
indicate variable data fields with underlines. The template for MYFORMAT is: 


PURCHASE ORDER REPORT 


CUSTOMER NAME: 
ADDRESS: 
DATE OF ORDER: 


ITEM NAME: 
STOCK NUMBER: QUANTITY: ___ 
UNIT PRICE: DATE REQUIRED: _ 
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4.2.1.5. Completing Pass 2 for MYFORMAT 


After you transmit the template (or pass 1) screen, it is redisplayed for you to complete 
pass 2. In pass 2, you fill in the type attributes for the various fields. (Refer to 4.1.2 for 
the rules concerning pass 2.) The type attribute screen for MYFORMAT is: 












PURCHASE ORDER REPORT 





CUSTOMER NAME: Xe 
ADDRESS: X STATE: A_ ZIP: 9 
DATE OF ORDER: 99/99/99 

ITEM NAME: Xe 


STOCK NUMBER: 999999 QUANTITY: 999 
UNIT PRICE: $9,999.99 DATE REQUIRED: 99/99/99 


aAN AU FWN = 






The screen can be analyzed as follows: 
a = Line 3 

Contains one alphanumeric field (CUSTOMER NAME). 
mw Line 4 


Contains three fields: one alphanumeric field (ADDRESS), one alphabetic field 
(STATE), and one numeric field (ZIP). 


= Line 5 
Contains three numeric fields separated by slashes (DATE OF ORDER) 

m Line 6 
Contains one alphanumeric field (ITEM NAME). 

m Line 7 
Contains two numeric fields (STOCK NUMBER and QUANTITY). 

w Line 8 
Contains four numeric fields (one for UNIT PRICE and three, separated by slashes, 
for DATE REQUIRED). The UNIT PRICE field is edited ($9,999.99). Later in the 
creation process (dialog screen 1) you can specify protection for the comma (,) and 


the decimal point (.). You may do this only for fields that are going to be used for 
input or both input and output. Output fields are always protected. 
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4.2.1.6. Completing Pass 3 for MYFORMAT @ 
After you transmit the type attribute screen, the after image of pass 1 (the template 
screen) is again displayed for pass 3. In pass 3, you indicate the |/O direction for each 
field (see 4.1.3) and you initiate dialog screens for the fields that require them. 

When the template screen first appears, the letter O (for output) is displayed in the first 
position of each field. Either you overwrite the O with the direction you want, or you 
accept it. 

If you require dialogs, initiate them for a particular field by: 

= Overwriting the O with an exclamation point (!) 

m Overwriting the O with an underline 

For certain fields, the SFG initiates dialogs for you automatically. These are: 

m Fields containing the edit character ! 


m Fields containing the edit characters , or . that can be protected. 


The pass 3 screen for MYFORMAT is completed as follows: 





PURCHASE ORDER REPORT 


CUSTOMER NAME: 
ADDRESS: 0 ZIP: O__ 


DATE OF ORDER: I_/I_/I_ 

ITEM NAME: 

STOCK NUMBER: ! QUANTITY: I__ 

UNIT PRICE: DATE REQUIRED: I_/I_/I_ 





The fields CUSTOMER NAME, ADDRESS, STATE, and ZIP accept the O default because 
they are all output fields. The DATE OF ORDER, ITEM NAME, QUANTITY, and DATE 
REQUIRED fields are all defined as input fields and do not require dialogs. An 
exclamation point (!) in the first character position of the STOCK NUMBER field indicates 
that dialog screens are required for this field. Although the UNIT PRICE field is defined 
as an input field on the screen, dialog screens are automatically initiated for this field 
because it was defined as an edited field in pass 2. 


Once you transmit the I/O screen, the dialog screen 1 for the first field requiring dialogs 
is presented. In the case of MYFORMAT, this field is the STOCK NUMBER field. 
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4.2.1.7. Completing Dialog Screens for MYFORMAT 
Recall from 3.5.1 that on dialog screen 1 you can specify 
m = An alternate field name 

= The I/O direction of the field 

mw ~The internal field length 

m An edit mask (for edited fields) 

m Insertion characters 

= Dialog screens 3 through 7 


For the STOCK NUMBER field, dialog screen 1 is completed as follows: 


STOCK NUMBER: 999999 


(FLD09009) IS FOR FIELD USE OF (@): 1 OUTPUT 2 INPUT 3 BOTH 
INTERNAL USAGE IS (1): 1 DISPLAY 2 PACKED 3 BINARY 6 ZONED 
INTERNAL LENGTH IS (06) 


PLEASE INDICATE WHETHER THE FOLLOWING ARE REQUIRED: 1 NO 2 YES 
CONDITIONAL DISPLAY (1) SPECIAL DISPLAY PROPERTIES (Q) 
CONDITIONAL RETENTION (1) CONDITIONAL PROTECTION (1) 
RANGE CHECKING (1) 


OON A UFWHND wo 





The SFG default for field name is accepted, and the |/O direction is specified as input. 
You accept the values displayed for internal usage and internal length. Since the 
specifications for MYFORMAT call for blinking the STOCK NUMBER field when an entry 
is invalid, SPECIAL DISPLAY PROPERTIES is selected. The STOCK NUMBER field is not 
an edited field, nor does it require insertion characters. Therefore, lines 10 and 11 are 
blank. 


Since the STOCK NUMBER field is defined as an input field, dialog screen 2 
automatically appears after you transmit dialog screen 1. (Refer to 3.5.2 for a complete 
explanation of dialog screen 2's function.) 
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1. STOCK NUMBER: 999999 

2. 

3. FIELD RESPONSE (1): 1 OPTIONAL 2 REQUIRED 3 MUST-FILL 4 DEFAULT VALUE IS: 
4. 

5. 

6. 

7. 

8. 

9. 

10. NOTE: FOR DEFAULT, ALPHA CHARACTERS WILL BE PASSED TO PROGRAM IN UPPER OR LOWER 
11. CASE AS ENTERED. FOR REPLENISH, ALPHA CHARACTERS WILL BE DISPLAYED AS ENTERED. 


For the purposes of MYFORMAT, FIELD RESPONSE must be optional. (Remember that 
when all the items for a particular customer have been entered, all O's are entered in 
the ITEM NAME field. This signals the program to display the next customer name and 
address. Therefore, the field can’t be a MUST-FILL field or a REQUIRED field, nor does 
it need a default value.) No special replenishing value is needed for this field; underlines 
are perfectly suitable for the application. Since all the dialog screen 2 defaults meet the 
field's requirements, simply transmit the screen as is. 


The final dialog screen that appears for the STOCK NUMBER field is dialog screen 4, 
the special display properties dialog. (Refer to 3.5.4 for a discussion of its function.) 


It should be completed as follows: 


1. STOCK NUMBER: 999999 

ra DISPLAY PROPERTIES FOR FIELD FLDOO009 INTENSITY: EMPHASIS: 

3. LOWEST PRECEDENCE: 1. DEFAULT PROPERTIES (A) 

4. II. OPTION IND (i 

5 III. OPTION IND C5 

6. IV. OPTION IND (_ (_) 

Ti HIGHEST PRECEDENCE: V. OPTION IND (_) 

8. INTENSITY: EMPHASIS: 

9. és NORMAL INTENSITY - UNDERLINED 4. REVERSE VIDEO 
10. . ALTERNATE (LOW) INTENSITY . COLUMN SEPARATORS 5. BLINK FIELD 
11. . NOT DISPLAYED STRIKE THRU BARS 6. POSITION CURSOR 
12. ‘—. SAME AS FIELDS IN ERROR 


On line 4, you supply the indicator number that controls when the STOCK NUMBER field 
blinks. This number is the same as the indicator number specified for the error message 
field. This means that when indicator number 2 is on, it triggers two things: the display 
of an error message on the error message field and blinking of the invalid entry for the 
STOCK NUMBER. Blinking occurs when the indicator is on because the intensity chosen 


for this condition is SAME AS FIELDS IN ERROR (the SFG’s method of highlighting a 
field entered in error). 
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Once you transmit dialog screen 4 for the STOCK NUMBER field, dialog screen 1 
automatically appears for the next field requiring dialogs. This field is the UNIT PRICE 
field. Dialog screen 1 is automatically initiated for this field because it is an edited field 
and requires an edit mask for the decimal point and comma within the field. UNIT PRICE 
also prompts dialog screen 2 because it is an input field. The sequence of dialogs 
follows: 


m Dialog Screen 1 





‘1s UNIT PRICE: $9,999.99 
2. 
3. (FLD00011) IS FOR FIELD USE OF (@): 1 OUTPUT 2 INPUT 3 BOTH 
4. INTERNAL USAGE IS (1): 1 DISPLAY 2 PACKED 3 BINARY 6 ZONED 
5; INTERNAL LENGTH IS (06) 
6. PLEASE INDICATE WHETHER THE FOLLOWING ARE REQUIRED: 1 NO 2 YES 
7. CONDITIONAL DISPLAY (1) SPECIAL DISPLAY PROPERTIES (1) 
8. CONDITIONAL RETENTION (1) CONDITIONAL PROTECTION (1) 
9. RANGE CHECKING (1) 
10. USE A '/' TO MARK PROTECTED EDIT CHARS IN THE FOLLOWING LINE 
11. SEI 
Note that on line 11, you overwrite the comma and decimal point with a slash, 
indicating that these characters are to be protected. 
m Dialog Screen 2 
de UNIT PRICE: $9,999.99 
2. 
a. FIELD RESPONSE (1): 1 OPTIONAL 2 REQUIRED 3 MUST-FILL 4 DEFAULT VALUE IS: 
4. Bag” 260. 
5 
6. INITIAL REPLENISHING VALUE IS: 
7. Sa ee 
8. 
9. 
10. | NOTE: FOR DEFAULT, ALPHA CHARACTERS WILL BE PASSED TO PROGRAM IN UPPER OR LOWER 
11. | CASE AS ENTERED. FOR REPLENISH, ALPHA CHARACTERS WILL BE DISPLAYED AS ENTERED. 





Since the SFG defaults are appropriate for the UNIT PRICE field, dialog screen 2 is 
transmitted without any modifications. 
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When you transmit dialog screen 2 for the UNIT PRICE field, creation of MYFORMAT is 
complete. At this point, the home screen is displayed for you to select another function. 
When you run your program, the format the order entry clerk sees is: 


PURCHASE ORDER REPORT 


CUSTOMER NAME: 
ADDRESS: 

DATE OF ORDER: 
ITEM NAME: 


QUANTITY: ___ 
UNIT PRICE: $_,___.___ DATE REQUIRED: 
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4.3. OVERLAY FORMATS 


Recall from 3.3.3 that an overlay format physically overlays a portion of your original 
format. When your program requests the display of an overlay, the overlay acts as an 
addition or extension to your original format. You can use it to input information to or 
output information from your program. Overlays can cover the entire workstation screen 
or just a portion of it. : 


4.3.1. The Need for an Overlay Format 


The use and subsequent advantage of an overlay format are best illustrated with an 
example. Suppose that your program uses an original format that is displayed as: 


SALES ORDER 


CUSTOMER NAME: 
ADDRESS: 

CITY: 

ITEM: 


cost: $_, 
QUANTITY: 


SALESMAN: 





All the fields are input fields a salesman at a workstation fills in. Every time the 
salesman transmits a screen, your program checks the inventory levels to make sure 
there’s enough of the ordered item in stock. If there is, the screen format is replenished 
with underlines and the salesman can enter the next order. If a stock item is unavailable, 
your program displays an overlay format. This overlay offers the salesman alternatives 
to the item originally requested. 


For example, a salesman enters the following order: 


SALES ORDER DATE: Byaebyz-r4 
CUSTOMER NAME: EUMOCCMCESSCETEES 


ADDRESS: (ASL ERnemenamcrne 
CITY: EYMMeeeee) =| STATE: ZIP: Gee 


ITEM: [AMnekeRnay 


STOCK NUMBER: 
cosT:$_, SUR) 

QUANTITY: [J_ 

SALESMAN: HfeisameSiuamaal 
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When your program checks the inventory level of R-Widgets, it finds only five in stock. 
The quantity requested is 10. Under the circumstances, your program overlays the 
lower half of the screen format with an overlay format. The overlay offers the salesman 
a choice of other similar stock items or the option of backordering the items that are 
not available. The display the salesman sees is: 


1. SALES ORDER DATE: 15/05/82 
2. CUSTOMER NAME: John Doe Associates_ 

3. ADDRESS: 123 Main Street 

4. CITY: Philadelphia___ STATE: PA ZIP: 19108 

5. ITEM: R-Widgets__ 

6. p> ITEM IS NOT AVAILABLE 

7. YOUR ALTERNATIVES ARE: 

8. 1. A-WIDGETS 2. C-WIDGETS 

9. 3. E-WIDGETS 4. BACKORDER ITEM REQUESTED 

10. ENTER ALTERNATE SELECTION NUMBER_ 





Lines 6 through 10 constitute the overlay format. On the overlay, the salesman makes 
his choice and transmits the screen. Your program then writes the original format and it 
is ready for the next order. 


It is important to note that only one format can be active on a workstation screen at a 
time. What this means is that when the overlay is displayed in the example above, a 
salesman can enter information only on lines 6 through 10. He can’t go back and make 
a correction to any of the information from the original format. 


Now consider another example in which two overlay formats are used. 


gs An input format is displayed at the workstation. 





= §=©«The workstation operator enters information and transmits. 


NAME : SIGE Yiene a 


EMPLOYEE NO. : Seas 
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m= An overlay format with corresponding employee information is selected by the 
program. 


NAME: JOHN SMITH 

EMPLOYEE NO. :54123 

DEPT #:103 DEPT. NAME:BILLING 

DATE OF HIRE:72/06/10 

DO YOU WISH SALARY INFO (YES, NO):___ 





m= The operator answers YES to the question on the last line and transmits. A second 
overlay format displays the requested information. 


NAME: JOHN SMITH 
EMPLOYEE NO. :54123 
CURRENT SALARY :$20000 


PREVIOUS INCREASE: 8% DATE: 790601 
GRADE:D 
MIN: $15000 MID :$19000 MAX: $23000 





Use of an overlay can be initiated or terminated, depending on the application of your 
program. The important thing to remember is that an overlay format, although it can 
look the same as the original, is a completely separate format. It must be created 
separately and as a result has its own format name as well as field ID's. Logically 
speaking, an overlay format would be created after an original format so that its 
eventual positioning on the workstation screen, as it relates to the original format, can 
be determined. 


4.3.2. Creation of an Overlay Format 


An overlay format is created in much the same way as an original format. The steps for 
creation are: 


1. Activate the SFG via LOGON and RV SFGEN. 


2. Complete home screen. On the characteristics screen, use answer 2 (OVERLAY) 
on line 3 for SCREEN FORMAT IS. 


3. Complete any requested optional screens. 
4. Complete template, type attribute, and I/O screens. 


5. Complete any requested dialogs. 
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The only difference between the creation of an overlay and an original format occurs in 
pass 1 — the template screen. If you want the overlay to replace, at some point, lines 6 
to 10 of an original format, you must begin the overlay on line 6 of the template 
screen. You must also place the start-of-entry character (SOE P) in the first position of 
that line. It indicates that the format is an overlay whose point of entry on an original 
format will be on line 6. The position of the cursor at transmission marks the end of the 
overlay format. 


For example, to create an overlay for lines 6 through 10 of the following sample original 
format: 


SALES ORDER 


CUSTOMER NAME: 
ADDRESS: 

CITY: 

ITEM: 


COST: $_,__ 
QUANTITY: ___ 
SALESMAN: 


COON AU FWD 





you must complete pass 1 for the overlay format as follows: 


6. > ITEM IS NOT AVAILABLE 

7. YOUR ALTERNATIVES ARE: 

8. 1. A-WIDGETS 2. C-WIDGETS 

9. 3. E-WIDGETS 4. BACKORDER ITEM REQUESTED 
10. ENTER ALTERNATE SELECTION NUMBER _ 





The start-of-entry character marks the beginning of the overlay, and the cursor marks 
its end with respect to the original format. When the template screen is transmitted, the 
type attribute screen is displayed for this 2-line format. Since it is a completely 
independent format, the type attributes that you specify may be different from those 
specified for the original. The same is true of I/O directions. You may also initiate 
dialogs for one or both of these fields. 


All overlay screens must begin with the start-of-entry character. Remember though, 
when .you place a start-of-entry character in the first position on the screen (1,1), that 
position is retained even when the start-of-entry character disappears in passes 2 and 
3. The first line of the generated screen always begins in position (1,2). No attempt 
should be made to shift back the incorrect line. 


The flexibility you are afforded when creating a new or using an existing overlay format 
parallels that of an original. The use of one or more overlay formats for inputting and 
outputting can be initiated by your program. An overlay format is incorrect only if it 
does not physically and logically fit in with the original format to accurately reflect the 
requirements of the program. 
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4.4. CREATING A FORMAT WITH DUPLICATE LINES 


When creating a screen format, you may specify that certain lines be duplicated without 
actually entering a line twice on the template screen. 


The variable data fields on any duplicate line are totally independent from the fields on 
the original line. Consequently, the characteristics for these fields, such as type 
attributes and I/O directions, may differ. 


To specify duplicate lines during creation, you enter the number of the line to be 
duplicated in the first position (or first and second positions for a 2-digit number) of the 
line where the duplicate is to appear. You could, for example, lay out the template 
screen in pass 1 as: 


PERSONAL CREDIT REPORT 


au kFWN a= 





This screen illustrates that lines 4 and 5 are duplicates of lines 2 and 3. Upon 
transmission, the type attribute screen is displayed as: 


PERSONAL CREDIT REPORT 


au FWN = 





Since duplicate lines are independent from the originals, the type attributes selected for 
the fields on these lines may be the same or different from the characters selected for 
the originals. You could, for example, complete pass 2 like this: 


PERSONAL CREDIT REPORT 99/99/82 


STATE: A__ ZIP: 9 


awk WN = 


STATE: A__ ZIP: 9__ 





Although the first field on line 3 is specified as alphanumeric, its duplicate on line 5 is 
alphabetic. 
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This same concept can be applied when completing pass 3. !/O directions for the 
duplicate fields can be the same as or different from those specified for the originals. It 
follows that you can initiate dialogs for a duplicate field but not its original and vice 
versa, or you Can initiate dialogs for both. You might complete pass 3 in this way: 


PERSONAL CREDIT REPORT 0_/0_/82 


STATE: B__ ZIP: ! 


STATE: B__ ZIP: ! 


au fFWN = 





The rules for specifying duplicate lines are: 
1. A duplicate line number must not be entered on the first line of a format. 


2. A duplicate line number entered in the first position of any line must be less than 
the number of the line on which it is entered. 


3. A duplicate line number specified in the first position (first and second positions for 
a 2-digit line number) must be followed by blanks for the rest of the line. 


If you violate any of these rules, the number is treated as part of the format (a display 
constant) when the template screen is transmitted. No blinking occurs as in other error 
conditions. 


Assume that you lay out the template screen in pass 1 as: 


PERSONAL CREDIT REPORT 


OON OU FWD 





Analyzing this screen, we see: 
w  =Lines 4 and 5 


Indicate that lines 2 and 3 are duplicated. 





UP-8802 Rev. 2 SPERRY UNIVAC OS/3 4-26 
SCREEN FORMAT SERVICES 








w Line 6 


Indicates that line 2 is not duplicated because blanks don’t follow the number. The 
SFG recognizes this line as a display constant. 


= Line 7 


Incorrectly specified because the number 10 is greater than the number of the line 
on which it appears. The number 10 is considered a display constant. 


gm Line 8 


Incorrectly specified because the first position contains a space. The number 3 is a 
display constant. 


lf these errors are not corrected before you transmit this screen, the type attribute 
screen is displayed as: 


PERSONAL CREDIT REPORT __/__/82 
NAME : 
ADDR: 
NAME: 


ADDR: 





2 PAST DUE AMOUNT: 
10 
3 


OON AU FWP = 





To make corrections, you can do one of two things: 
1. Return to the home screen (function key F1) and start the format over again. 


2. Complete passes 2 and 3 and any dialog screens. When the home screen is 
displayed, select the MODIFY function (Section 5) to correct the format. 
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5. Modifying Formats 


5.1. CREATE-FROM AND MODIFY FUNCTIONS 

The CREATE-FROM and MODIFY functions are essentially the same. CREATE-FROM 
allows you to create a new format by changing an existing format. The old format is 
not altered and is saved along with the new format in $Y$FMT or a user-assigned 
library file for future use. 


MODIFY also allows you to create a new format by changing an existing one; however, 
the old format is not saved. After modification, it becomes the new format. 


Among the changes you can make via the CREATE-FROM and MODIFY functions are: 
m= Change any format level specification from the characteristics screen. 

m Change features that were defined through optional screens. 

m Change the format’s layout: Add fields, delete fields, and change field lengths. 

m Change field type attributes. 

@ Change field |/O directions. 

w Change field characteristics that were defined through dialogs. 

= Replace lines. 

m Add or insert new lines. 

w Delete lines. 


m Change only the format’s layout (without adding or deleting fields or changing their 
length). 
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If you understand all of the steps involved in the CREATE function, the functions 
discussed here should present little or no difficulty. To initiate either one, you must 
perform the following operations: 


1. Activate the SFG, using LOGON and RV SFGEN. This results in a display of the 
home screen: 


FUNCTION (1): 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 
OLD FORMAT NAME (¢ ) IS ON THE FOLLOWING LIBRARY: 
FILE NAME: (SYSFMT ) VOLUME: (RES 


NEW FORMAT NAME (¢ ) IS TO BE STORED ON THE FOLLOWING LIBRARY: 
FILE NAME: (SYSFMT ) VOLUME: (RES ) 
IF THIS FILE DOES NOT EXIST, ALLOCATE (002) CYLINDERS. INCREMENT IS (@1) CYL. 


=A OAN AU FWN = 


0. **FUNCTION KEYS ARE:F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, 
1 F13-HELP, F14-EXIT HELP, F20-RESTORE SCREEN 





2. Select the appropriate function code and overwrite the default on line 1. 


3. Provide the old and new format names for CREATE-FROM and old name for 
MODIFY. 


You can then make the appropriate changes to the old format. 


5.1.1. Modify Screen 


Specific changes to an old format are initiated through the modify screen, which is 
displayed as in Figure 5-1. 


1. MODIFY OPTION (1): 1 CHANGE TEMPLATE 2 CHANGE TYPE 3 CHANGE I/0 
2. 7 CHANGE TEMPLATE ONLY - NO INTERNAL CHANGES 





Figure 5-1. Modify Screen 


The modify screen (Figure 5-1) lists four options that can be used to change an existing 
format. You specify your selection by overwriting the default value on line 1 with any of 
the other acceptable values. Completing and transmitting the modify screen produces 
results characteristic of the option that you select. 
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5.1.1.1. Modify Screen — Option 1 (CHANGE TEMPLATE) 


The sequence of steps for this option is quite similar to those for the CREATE function. 
After you transmit the modify screen, the characteristics screen automatically appears 
for you to make changes to your format. The values that appear on the characteristics 
screen are the ones you specified when you created the format. You can overwrite any 
of the values on the screen with new values. If you originally selected options that 
prompt optional screens or if you initiate new optional screens, these too will appear 
automatically after you transmit the characteristics screen. You can change any of the 
values that appear on the optional screens. 


After you transmit the last optional screen (or after you transmit the characteristics 
screen if no optional screens were requested), the after image of the template screen 
for the old format is displayed without protection. You can rearrange the format or 
change any portion of the format layout, including display constants or the length of any 
field. You may also delete and add fields. 


When the template screen is transmitted, the type attribute screen is displayed for you 
to define type attributes for every field in the format - changed as well as unchanged 
ones. In other words, you must complete this screen as if the format were being 
created for the first time whether the type attribute characters are to be the same as 
when the format was originally created or not. 


When the type attribute screen is transmitted, the I/O screen is displayed for you to 
complete in the same manner by specifying I/O directions for all the fields in the format, 
as well as initiating dialogs for any fields that require them. If one or more dialog 
screens were used during creation to provide certain characteristics (such as range 
checking, and replenishing values) for a field, you must initiate dialogs again for that 
field if you want these characteristics to be retained. 


When all three passes and any dialog screens are completed, control returns to the 
home screen for you to select another function. 


NOTE: 


If function key 20 is pressed during this option, an SFG9O (FUNCTION NOT 
SUPPORTED) message appears. 


5.1.1.2. Modify Screen — Option 2 (CHANGE TYPE) 


When you select option 2, you're first presented with the characteristics screen, where 
you can specify any format-level changes you wish to make. If any optional screens 
were requested (either when the format was created or as a result of changes to the 
characteristics screen), they appear after you transmit the characteristics screen. Once 
you've transmitted the optional screens (or the characteristics screen if no optional 
screens were requested), the after image of the type attribute screen for the old format 
is displayed. 


On this display, you may only change type attribute and edit characters for any field. 
You may not change any display constants or delete, add, or change the length of any 
field. You may not rearrange the format in any way. 
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When this screen is transmitted, the I/O screen is displayed for you to define the I/O 
directions for every field in the format and to initiate dialogs as necessary. When all 
dialogs are completed, control returns to the home screen. 

5.1.1.3. Modify Screen —- Option 3 (CHANGE I/O) 

If you select this option, the characteristics screen appears first, just as it does for 
options 1 and 2. After you transmit the characteristics screen and, if requested, any 


optional screens, the after image of the I1/O screen for the old format is displayed. You 
may only change the I/O directions and initiate dialogs for the fields as necessary. 


5.1.1.4. Modify Screen — Option 7 (CHANGE TEMPLATE ONLY - NO 

INTERNAL CHANGES) 
If you select this option, the characteristics screen is the first to appear. Unlike options 
1 through 3, however, there are certain changes you cannot make. This option only lets 
you alter the appearance of a format. It doesn’t let you make any changes that would 
affect the program interface. The changes you can make to the characteristics screen 
and any optional screens that appear as a result are: 
s Alphabet 
m Error retry count 
m Edit screen: any character 


m= Special display screen: any parameter 


m Error message screen: number of lines in error message and any parameter except 
the indicator 


You may change the format’s layout by doing one or both of the following: 


m Change one, ail, or none of the display constants and/or their location on the 
template screen. 


m Change the location of fields on the template screen. 
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In either case, you may not change the order of the fields, nor may you add, delete, or 
change the length of any field. The following is the template screen for an old format. 










PERSONAL CREDIT REPORT 





NANG holo Sccten rahe cc Co ee 

POOR eee act tt a ee eee 
PAST DUE AMOUNT: 
NEW BALANCE: 
MINIMUM PAYMENT: 








Modifications might result in: 







PERSONAL CREDIT REPORT 


ACCOUNT NUMBER: PAST DUE AMOUNT: 


DUE DATE:__/__/ 






Notice that two display constants have been changed: ADDR to ADDRESS and 
MINIMUM PAYMENT to MIN PAYMENT. The corresponding field lengths have not been 
altered, nor have any other field lengths. Fields have not been added or deleted, and the 
order of the fields is unchanged: PAST DUE AMOUNT still follows ACCOUNT NUMBER, 
NEW BALANCE still follows PAST DUE AMOUNT, and so on. Each field retains the 
same type attributes, I/O directions, and dialog-provided characteristics that were 
specified when the format was originally created. In other words, there are no internal 


field changes. 


If you inadvertently change the length of a field, the following error message is 
displayed: 


SFG3@ INTERNAL FIELD HAS BEEN CHANGED. 
UPDATE NOT COMPLETED. 


You must correct the field length. Upon transmission of the template screen, whether 
you've rearranged it or not, modification is complete and the home screen is displayed 


for you to select another function. 
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5.2. MODIFICATION SUMMARY 


The CREATE-FROM and MODIFY functions allow you to create a new format by 
changing an existing one. The method you use depends on the changes that you want 
to make and which of the previously described options affords the simplest means for 
making them. The following diagram provides a general summary of these options. 


HOME SCREEN 
Py SCREEN 
seen SCREEN 
OPTION 1: CHANGE TEMPLATE 
mee 1— PASS 2-—> PASS 3-— DIALOG SCREENS —> HOME SCREEN 
OPTION 2: CHANGE TYPE 
me 2—> PASS 3-> DIALOG SCREENS — HOME SCREEN 
OPTION 3: CHANGE I/O 
pase 3 — DIALOG SCREENS -> HOME SCREEN 
OPTION 7: CHANGE TEMPLATE ONLY - NO INTERNAL CHANGES 


t 
PASS 1—» HOME SCREEN 





Keep in mind that you can terminate the CREATE-FROM or MODIFY functions 
(regardless of the option you're using to accomplish the changes) by using the F1 
function key at any point before completion of the actual changes. You may also initiate 
the HELP function at any point except pass 1 during the CREATE-FROM or MODIFY 
function. 


NOTE: 


If you press XMIT before moving the cursor in pass 1 of the CREATE-FROM function, 
modify option 1, or modify option 7, the following message appears: 


SFG12 NO DATA ENTERED-POSITION CURSOR TO END OF SCREEN, XMIT 


If this happens, simply make the desired entries and press XMIT. 
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6. Additional Functions 


6.1. DISPLAY FUNCTIONS 


Each of the three display functions - SHOW, LIST, and SPOOL - gives you a display of 
information about an existing format. 


When you want to change a format via the MODIFY function, for example, a display of 
the old format is useful in determining what changes you want to make. Depending on 
which display function you choose, you can obtain a general format display at the 
workstation, a listing of the detailed field characteristics at the workstation, or a printed 
listing of both. 


The DELETE function deletes a chosen format from the library (SY$FMT or a 
user-assigned library, see Appendix A) and the TERMINATE function ends the SFG 
session. 


6.1.1. SHOW Function 


You initiate this function by entering function code 5 on line 1 of the home screen and 
by entering the old format name on line 3. When the home screen is transmitted, you 
get a workstation display of the existing format with its field type attributes. Input-only 
fields will contain their replenish values to distinguish them from bidirectional fields. 


You may use the TAB key to help you identify the protected fields from unprotected 
fields. The cursor automatically stops at the beginning of each unprotected field each 
time the TAB key is pressed. The low-intensity display of protected fields also helps 
you to make the distinction. 

6.1.2. LIST Function 

This function is initiated by entering function code 6 on line 1 of the home screen. Its 
purpose is to provide comprehensive information about a format as a whole and about 
the individual fields in a format. The information the LIST function provides includes: 


a A summary of format-oriented information from the characteristics screen 


= Details from any optional screens originally requested for the format 
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= The type attributes and characteristics of all fields 

= Details from any dialog screens originally requested for any field 

m Details about the input and output data structures showing the data 
m = Interface to the user program 


The LIST function provides all this information by displaying a series of screens at your 
workstation. 


When you transmit the home screen, a Summary screen is displayed for you. This 
screen contains a synopsis of what was specified on the characteristics screen when 
the format was created. When you transmit the summary screen, the next screen (or 
series of screens) displayed depends on how the format was created. 

If the format incorporated any of these options: 

m Special editing characters 

= Special display control 

= An error message field 

® Function/command keys 

then the next series of screens will include one or more of these displays: 

w A special editing display 

= A display control and error message display (This is one screen.) 

= =A function/command key display 

Following transmission of these screens, you get a display of the format as it was 
created. If none of the above options were selected for the format, then this display of 
the format follows immediately after you transmit the summary screen. 

After you transmit the display of the format, the next screen to appear is the list 
screen. This screen displays detailed characteristics of the fields in the format, such as 
field ID, 1/O directions, and external lengths. At this time, you may also request sublist 
screens and conditional values screens. Sublist screens provide any field response 
requirements, default values, range check values, and replenishing values that were 
specified for any fields via dialogs. Conditional values screens display any conditional 


features and conditional indicators that were specified for fields, also through dialogs. 


Finally, input record screens display the internal location of input fields, and output 
record screens display the internal location of output fields. 
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NOTES: 

1. When you use the LIST function, it is displayed in two parts if your format consists 
of more than 12 lines. 

2. If your format is using line 12 or 24, any characters in columns 79 and 80 are not 
displayed. 

3. The preceding notes do not apply to either the SHOW or SPOOL functions nor do 


they affect the detailed output of the LIST function. 


6.1.2.1. Summary Screen 


Figure 6-1 shows a typical display of the first screen presented for the LIST function 
for an old format. 


p= = DAN OU FWD = 


NAME: FORMATO1 FORMAT SIZE: @7 X 64 DATE: 05/25/82 CREATED FROM: 

ALPHA: ENGLISH FILE: $SYSFMT ON RES GEN8 
LINE ORIGIN: @1,01 OVERLAY: NO ERASE/UNLOCK BY: CONDITIONAL INDICATOR 

LOWER CASE TRANSLATION: YES NUMBER OF VARIABLES: 0014 ERROR RETRY COUNT: 02 
SPECIAL EDITING CHARACTERS: YES SPECIAL DISPLAY CONTROL: YES 

ERROR MESSAGE FIELD SPECIFIED: YES DISPLAY RETENTION: YES 

FUNCTION OR COMMAND KEYS DEFINED: YES 

FORMAT HAS A NON-DISPLAY CONSTANT: NO 


INPUT ONLY FIELDS TO BE REPLENISHED: INDICATOR IS Y006 





Figure 6-1. Summary Screen 


Analyzing this screen, we see: 


Line 1 


Displays the format’s name (FORMATO1), its size (7 lines, the longest of which is 
64 characters), its creation date (05/25/82), and the name of the format from 
which this format was created (if one exists). 


Line 2 

Displays the language or character set (ENGLISH) that was used, the name of the 
screen format file (SY$FMT), the volume (RES) containing that file, and your release 
level (GEN8, indicating release 8.0). 

Line 3 

Displays the row and column number where the format begins on the screen, 


whether the format is an overlay format (NO), and how the format is erased and 
the keyboard unlocked (by CONDITIONAL INDICATOR). 
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mw Line 4 





Displays whether lowercase translation was specified (YES), the number of variable 
fields in the format (14), and the error retry count (02). 


a) Line 5 


Displays whether special editing characters were specified (YES) and whether 
special display control was requested (YES). When special editing is YES, it 
prompts the appearance of the special editing display. When display control is 
YES, it prompts the appearance of the display control/error message display. 
These screens appear after you transmit the summary screen. 


= Line 6 
Displays whether an error message field was specified (YES) and whether display 
retention was specified (NO). When YES is specified for the error message field, it 
prompts the appearance of the display control and error message display. 


B Line 7 


Displays whether function/command keys were specified (YES). When YES is 
specified, it prompts the appearance of the function/command key display. 


a Line 8 





Displays whether the format has a nondisplay constant (NO). When YES, the length 
of the constant is also displayed on line 8, and the value of the constant is 
displayed on line 9. 


= Line 10 


Displays the conditional indicator that controls whether input fields are replenished 
after input (as it was specified on the conditional erase/replenish screen). 


6.1.2.2. Special Editing Display 


This display is a facsimile of the original edit screen (3.4.3). It lists the user-defined 
characters, as well as the standard characters, and is shown in Figure 6-2. 


NAME: FORMAT@1 FORMAT SIZE: @7 X 64 DATE: 05/25/82 
SPECIAL EDITING CHARACTERS: YES 


STANDARD CHAR: MEANING CHAR TO BE USED 
$: CURRENCY SYMBOL ($) 
: DECIMAL POINT = (/) 


THOUSANDS PUNCT. : (,) 
REPLACEMENT CHAR = (*) 
CREDIT ON NEGATIVE (CC) 
DEBIT ON NEGATIVE = (DD) 
REPLENISH CHAR. = (-) 





Figure 6-2. Special Editing Display 
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@ 6.1.2.3. Display Control and Error Message Display 


This display summarizes what was originally specified on two optional screens: the 
special display control screen and the error message screen. It lists the display 
properties for display constants, output variables, input capable variables, and fields 
entered in error. It also lists the name of the error message field (if one was specified), 
along with the number of lines in the message and the line number where the message 
appears. A typical display control and error message display is shown in Figure 6-3. 


NAME: FORMAT@1 FORMAT SIZE: 07 X 64 DATE: 05/25/82 
DISPLAY CONSTANTS: (B)¢(____) OUTPUT VARIABLES 


INPUT CAPABLE VARIABLES: (A)(____) FIELDS ENTERED IN ERROR: (A) (1 
ERROR MESSAGE DISPLAYED ON LINE NUMBER : LAST 
ERROR MESSAGE FIELD NAME IS: ERRORMSG MESSAGE DISPLAY ATTRIBUTES: (B)( 


ERROR MESSAGE CONDITIONALLY DISPLAYED BASED ON INDICATOR (CY 0064) 


INTENSITY: EMPHASIS 


A.NORMAL INTENSITY 1.UNDERLINED 4.REVERSE VIDEO 
B.ALTERNATE (LOW) INTENSITY 2.COLUMN SEPARATORS 5.BLINK FIELD 
3.STRIKE THRU BARS 





Figure 6-3. Display Control and Error Message Display 


6.1.2.4. Function/Command Key Display 


This display is a facsimile of the function/command key screen. It shows key numbers 
and, if defined, the corresponding response for all possible function/command keys. 


Figure 6-4 shows a sample display of the function/command key display. 


NAME: FORMAT®1 FORMAT SIZE: 07 X 64 DATE: 05/25/82 
FUNCTION OR COMMAND KEYS DEFINED: YES 


KEY# ACCEPT? RESPONSE KEY# ACCEPT? RESPONSE KEY# ACCEPT? RESPONSE 


F1 (ND (900) F2 Y) (001) FS. CY) (065) 
F4 (Y) (003) F5 (Y) (000) F6 (ND (000) 
F7 (N) (000) F8 (ND (000) FO (N) (000) 
F10 (ND (000) F117 (N) (900) F112 (N) (000) 
F13 (N) (000) F14 (ND (000) F15 (ND (000) 
F16 (N) (000) F17 (ND (000) F189 CY) (025) 
F19 (N) (000) F20 CY) (174) F21. (ND (000) 

@ F22 (ND (000) 





Figure 6-4. Function/Command Key Display 
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6.1.2.5. The Format Display 





This display looks like the after image of pass 2, when the screen was created. It 
shows the type attributes for every field in the format. Figure 6—5 shows a typical 
format display. 


PERSONAL CREDIT REPORT 99/99/82 
NAME : AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
ADDR : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX STATE:AAA ZIP:99999 
SOCIAL SECURITY:999!199!9999 
ACCOUNT NUMBER: XXX -999999 
AMOUNT DUE:$99.999.99 
BALANCE:$$,$99.99 PAYMENT DUE DATE:99/99/99 


NOU PWD = 





Figure 6-5. Screen Format 


6.1.2.6. List Screen 


Figure 6-6 shows the next screen to be presented for the LIST function. 





NAME: FORMAT@1 FORMAT SIZE: 7 X 64 DATE: 05/25/82 
FIELD-ID (X,Y) 1/0 EXTRNAL INTRNAL RESPN REPLN RANGE COND 
TYP LNGH TYP BYT DIGIT 
FLDQ0001 N 2 D2 2. 
FLDQO002 2 2 2. 
30 36. 


D 

NAME 30 D 
ADDR 30 D 30 390. 

D 

P 


STATE 
FLD@0006 


4 4. 
3 5. 


WOON AU RFWYDN = 


MORE? (Y) 





Figure 6-6. List Screen 


Line 1 of the list screen (Figure 6-6) shows the format’s name (FORMATO’1), its 
size (7 lines, the longest of which is 64 characters), and its creation date 
(05/25/82). Line 2 displays the headings for the particular field characteristics listed 
in each column. The headings and corresponding column contents are: 


m FIELD - ID 


This column contains the names of the particular format fields. These are listed 
in the order defined during creation. In this example, SFG-provided names, as 
well as user-assigned names, are listed. 
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mw (Y, X) 


This column displays the Y, X coordinates (or the physical position) of each 
field. The Y coordinate is the line on which the field is located, and the X 
coordinate indicates the position of that field on the line. The field whose ID is 
FLDOOOO1, for example, is located on line 1 and starts at the 55th character 
position on that line. 


a 1/0 


This column displays the !/O usage for the fields in a format, where | is for 
input, O is for output, and B is for both (input and/or output). Refer to 4.1.3 
for a detailed discussion of I/O directions. 


m EXTRNAL 


This column indicates the external display type and the external display length 
for the format fields. The N 2 in this column means that field FLDOOOO1 is a 
numeric field with an external length of 2 (underlines). The abbreviations for the 
external field types are: 


Abbreviation Meaning 

N Fixed numeric field 

A Alphabetic field 

X Alphanumeric field 

NE Numeric edited field 

AE Alphabetic edited field 

XE Alphanumeric edited field 
@#  INTRNAL 


This column shows the internal usage of the field and the internal length. The 
D 2 for the first field means that its internal usage is display and its internal 
length is two bytes. The P 3 for the last field means that its internal usage is 
packed and its internal length is three bytes. Refer to 3.5.2 for a discussion of 
internal length and usage. The abbreviations for the internal usage types are: 


Abbreviation Meaning 

D Display 

B Binary 

P Packed decimal 


Z Zoned decimal 
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RESPN 


This column lists the field response requirements for input or bidirectional 
fields, where: 


M means MUST FILL. 

O means OPTIONAL. 

R = means REQUIRED. 

() means DEFAULT. 
Refer to 3.5.2 for an explanation of field response values. 
REPLN 


This column indicates replenishing values for input or bidirectional fields. A 
single character in the column shows the replenish value for the screen (either 
an underline or the character selected on the EDIT screen). A set of 
parentheses indicates that a unique replenish value has been specified for this 
field. Refer to 3.5.2 for an explanation of replenishing. 


RANGE 


This column indicates whether range checking has been requested for a field. 
The presence of a set of parentheses indicates that range checking has been 
requested. Refer to 3.5.8 for an explanation of range checking. 


COND 


This column indicates whether any conditional indicators were specified to 
control certain features of the field. A set of parentheses in this column 
signifies that indicators are used. 


At the bottom of the screen, the question MORE? is displayed. If you want a listing of 
the same type of information for more fields in the format, accept the default value (Y) 
and transmit. If you don't want any further listings, overwrite the default value with an 
N and transmit. si 


NOTE: 


lf any character other than a Y is entered for this question, the SFG assumes N and 
control is passed to the next screen. 


Through the information presented on this list screen alone, you can tell a great deal 
about the format without even having created it. 
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6.1.2.7. Sublist Screen 


The sublist screen, if initiated, displays the values that were specified (during creation 
via dialogs) for field response, range checking, and replenishing. Recall that a set of 
parentheses in the RESPN, REPLN, or RANGE column of the list screen indicates that 
specific values, other than SFG default values, have been assigned for that field. To find 
out what these values are, you simply enter a Y in any of these parentheses, depending 
on which, if any, of these values you want to know. Upon transmission of the list 
screen (either the last in an entire series of list screens or the one in which you answer 
N to the question MORE?), the sublist screens are presented. 


Let’s say that you make the shaded entries on the list screen: 


NAME: FORMATO1 FORMAT SIZE: 7 X 64 DATE: 05/25/82 
FIELD-ID (X,Y) 1/0 EXTRNAL INTRNAL RESPN REPLN RANGE COND 
TYP LNGH TYP BYT DIGIT 
FLD00001 2 2 
FLD@O002 2 2 


. NAME 30 30 
P ADDR 

STATE 

: FLD@0006 


OON A UU FWD = 





Upon transmission of the list screen, the sublist screen (Figure 6-7) is presented for 
FLDOOOO2: 


FIELD-ID (Y,X) 1/0 EXTRNAL INTRNAL RESPN REPLN RANGE 
TYP LNGH TYP BYT DIGIT 
FLD@O002 1,58 N 2 DB 2. 2. (Y) (Y) (Y) 


DEFAULT VALUE: 
01 


REPLENISHING: 
99 
RANGE: 


BTW 01-04 
BTW 06-08 
GT 13 


e PF O ON OAM FSF WED = 


= © 
. e 





Figure 6-7. Sublist Screen 
Analyzing this screen, we see: 
mw Lines 1 and 2 


Display the same headings as lines 2 and 3 of the list screen. 
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m Line 3 
Is a duplicate of line 4 of the list screen. 
m Lines 4 and 5 


Show that the value 1 was chosen by the format’s creator (via dialog screen 2) as 
the default response (field RSP) for field FLDOOOO2. 


@ Lines 6 and 7 
Show that the replenishing value for the field is 9’s instead of underlines. 
mw ~=Lines 8-11 
Show the types of range checks and the corresponding range check values that 


were selected for field FLDOOO02 via dialog screen 7. The abbreviations for the 
range check types are: 


Abbreviation Meaning 

BTW Between 

NEQ Not equal 

EQU Equal 

GT Greater than 

LT Less than 

GE Greater than or equal 
LE Less than or equal 


Refer to Section 3 for an explanation of field responses, range checking, and 
replenishing. 


Upon transmission of this sublist screen, another sublist screen with the requested 
values is displayed for the next field requesting it and so on until all fields are taken 
care of. If there are no further sublist screens to be displayed, input and output record 
screens are displayed. 
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6.1.2.8. Conditional Values Screen 


This screen, if initiated, displays which features of a field are conditionally controlled 
and the indicators that control them. You prompt the display of the conditional values 
screen in much the same way that you prompt the sublist screen. Recall that a set of 
parentheses in the COND column of the list screen means that conditional indicators 
were specified for a field. By keying a Y in the parentheses on the list screen, you 
prompt the display of the conditional values screen. 


Figure 6-8 shows a typical conditional values screen display. 


FIELD-ID (X,Y) 1/0 EXTRNAL INTRNAL RESPN REPLN RANGE COND 
TYP LNGH TYP BYT DIGIT 


FLD@0006 3,56 (p> 


FIELD IS TO BE DISPLAYED IF INDICATOR 009 IS ON. 
FIELD IS TO BE RETAINED. 

FIELD IS TO BE PROTECTED IF INDICATOR @@2 IS OFF. 
CURSOR IS EXPLICITLY POSITIONED TO THIS FIELD 


ae DAN A VF WN = 
. « © 8 © 8 2 


= oO» 


DISPLAY PROPERTIES ARE NORMAL INTENSITY WITH REVERSE VIDEO 
IF INDICATOR 914 IS ON. 





Figure 6-8. Conditional Values Screen 


Analyzing this screen, we see: 

m@ Lines 1 and 2 
Display the same headings as line 2 of the list screen. 

w Line 4 
Is a duplicate of line 4 of the list screen. 

mw Line 6 
Shows that the field (FLDOOOO6) is displayed when indicator 009 is on. (This 
indicator would have been originally specified on dialog screen 3 when the format 
was created.) 


mw Line 7 


Shows that the contents of the field are retained whenever indicator O05 is on. 
(This indicator would have been specified on dialog screen 5.) 
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# Line 8 


Shows that the field is protected when indicator 002 is off. (Originally specified via 
dialog screen 6) 


@ Line 9 


Shows that the cursor is always positioned at this field. (As specified via dialog 
screen 4) 


@ Line 11 


Shows the display properties associated with this field when indicator 014 is on. 
(As specified via dialog screen 4) 


To display the conditional values screen for the next field you requested, simply press 
the XMIT key. Upon transmission of the last conditional value screens, you're presented 
with the input and output record screens. 


6.1.2.9. Input Record Screen 


The input record screen displays the internal displacement in bytes for a particular field 
name in the input record. You may receive an input record screen upon transmission of 
a sublist screen or list screen if no sublist screen exists. Figure 6-9 contains an input 
record screen. : 


INPUT RECORD 
FIELD NAME DISPLACEMENT 
FLDOO002 @ 
NAME 2 


ADDRESS 32 
STATE 62 
FLDO9006 66 


NOW FWD = 





Figure 6-9. Input Record Screen 


Analyzing this screen, we see fields FLDOOOO2, NAME, ADDRESS, STATE, and 
FLDOOOO6G exist in the input record and that FLDOOOO2 has an internal location of O, 
NAME has an internal location of 2, ADDRESS has an internal location of 32, STATE 
has an internal location of 62, and FLDOOOO6G has an internal location of 66. 


6.1.2.10. Output Record Screen 
The output record screen displays the internal displacement in bytes for a particular field 


name in the output record. You receive an output record screen upon transmission of 
the last input record screen. Figure 6-10 contains an output record screen. 
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1. OUTPUT RECORD 

re FIELD NAME DISPLACEMENT 
3. FLDO00001 0 

4. ADDR 2 

5. STATE 32 

6. FLD@G006 36 


Figure 6-10. Output Record Screen 


Analyzing this screen, we see the fields FLDO00001, ADDR, STATE, and FLDOOOO6 
exist in the output record and that FLDOOOO1 has an internal location of 0, ADDR has 
an internal location of 2, STATE has an internal location of 32, and FLDOOOO6 has an 
internal location of 36. When the last output record screen is transmitted, control 
returns to the home screen. 


NOTE: 


A field specified as bidirectional (both input and output) appears on both the input and 
output record screens. 


6.1.3. SPOOL Function 


This function is initiated by entering the function code 7 on line 1 of the home screen 
and by supplying the old format’s name on line 3 of the home screen. The SPOOL 
function is similar to the LIST function, except your screen formats are printed rather 
than displayed and responses are not required. All information regarding your format is 
always printed. After a job terminates, all screen formats are printed. However, if you 
want to have any screen formats printed before termination, you can breakpoint the 
spool file by pressing function key 5. 


6.2. DELETE AND TERMINATE FUNCTIONS 


The DELETE function allows you to delete a format from its library file. It is initiated by 
entering the function code 4 on line 1 and the old format’s name on line 3 of the home 
screen. Upon transmission of the home screen, the format is displayed at the 
workstation along with the following question. Note that the underlines will be replaced 
by the name of the format to be deleted. 


IS THE SCREEN FORMAT YOU WISH TO DELETE? Y OR N? (_) 


If you're sure that you want to delete the displayed format, enter Y and then press the 
XMIT key. If you decide not to, enter N and then press the XMIT key. 
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NOTE: 





There is no error indication for an incorrect response. If the response to this question is 
anything other than Y (YES), then N (NO) is automatically assumed and the format is 
not deleted. 


As mentioned in 3.2.1, the TERMINATE function ends the SFG session. 
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7. Associating Formats with 
a Program: Using the Screen 
Format Coordinator (SFC) 


7.1. PROGRAMMER RESPONSIBILITIES 


Now that you know the many functional capabilities that the SFG gives you to create 
and maintain screen formats, let's see how screen formats are incorporated into a 
program. 


As mentioned in 1.2 and 1.4, the SFC has such responsibilities as retrieving the formats 
that the program is going to use, checking certain data, and controlling the flow of data 
between the program and the format. Although it isn’t necessary for you to be 
concerned with the specifics of the SFC’s activities, there are still certain responsibilities 
that you have in making the actual connection between screen formats and the 
program. Among these are making sure that the SFC knows where to retrieve the 
format, providing the proper job control statements for the format’s file, including the 
appropriate references to the formats within the program, and incorporating any 
indicators that your format relies on. 


7.2. JOB CONTROL 


To execute a program that uses screen formats, you are responsible for providing the 
proper job control statements. These statements are basically the same as they would 
be for any program that’s executed at a workstation. 


You must provide a device assignment set or DVC/LFD sequence for every file that the 
program uses, including the workstation file, and, if the format is stored on a location 
other than the $Y$FMT library (see A.1.), the format’s library file. In addition to the 
standard job control language (JCL), you must indicate within the DVC/L_FD sequence for 
the workstation that screen format services are to be provided. You do this via the // 
USE SFS statement. 
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The format for the USE statement is: 


[format-file-lfd-1]/[ format-file-lfd-2] 





//[{symbol] USE SFS | 


format-file-lfd 


cara Ce | 
1 


[,screen-format-1=alias-1,...,screen- format-12=alias-12] 


As you can see, most of the parameters in this statement are optional, so that if your 
format is stored on $Y$FMT the following alone is sufficient to indicate the use of 
screen format services: 


// USE SFS 


With this statement included in the DVC/LFD sequence for the workstation file, your 
program can retrieve any format from $Y$FMT simply by issuing the proper calling 
statement (peculiar to the program's language) and the name of the format being called. 
The optional parameters may be used as necessary and are explained in detail in A.1. 


The job control stream to execute a program using screen formats must always include 
a DVC/LFD sequence, which contains the USE statement, for the workstation. Also, 
note that when two or more workstations access formats in the same screen format 
file, the DVC, USE, and LFD job control statements (with a unique LFD) must be 
provided for each workstation. And that, when the workstation accesses only one 
screen format file residing on RES, no DVC/LFD sequence is required for the file. 


NOTE: 


If more than one screen format file resides on RES but not in $Y$FMT, a DVC/LFD 


sequence (with a unique LFD) must be provided for the file in order for the workstation 
to access it. 
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Example 1: 


// JOB MYJOB 


// DVC 5® 

// VOL DOOO29 DVC/LFD sequence for the user library 
// LBL FORMAT with a unique LFD 

// LFD FMT 

// OVC 200 

// USE SFS,FMT 

// LED WRKSTN 


DVC/LFD sequence for 
the workstation 


// EXEC JOBO1 


This example shows the job control statements required for a single workstation to 
access a single format on a user library. There are two DVC/LFD sequences in this 
example: one indicating the user library where the format resides (on disk volume 
DO0029), and one indicating a workstation, where the device code number is 200 and 
the name that the program uses to reference it is WRKSTN. Note that the DVC/LFD 
sequence for the user library provides a unique LFD for the forrnat. That LFD is 
specified in the USE statement to indicate which format is to be used. 


Example 2: 


// JOB PAYROL 


// DVC 200 
// USE SFS 
// LFD WRKSTN 


DVC/LFD sequence for 
the workstation 


// EXEC PRSNL 


This example shows the job control statements required for a single workstation to 
access a single format that resides in the screen format library $Y$FMT on RES. It 
contains a DVC/LFD sequence for the workstation, where the device code number is 
200 and the name that the program uses to reference the workstation is WRKSTN. The 
format to be used is on $Y$FMT; therefore, no DVC/LFD sequence is given for the file. 
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Example 3: 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


DVC 
VOL 
LBL 
LFD 
DVC 
LBL 
LFD 
DVC 
USE 
LFD 


50 

123456 

FORMAT 

FMT1 

RES 

SYSFMT 

FMT2 

200 (2) 
SFS,FMT1/FMT2 
WRKSTN 


This example indicates formats required by your program are located in two format 
libraries. When your program requests a screen format, the file labeled FORMAT is 
searched first. If the requested format is not located, the secondary format file is 
searched. 


For more information concerning the USE SFS statement and for more specific job 
control examples, see A.1. For general job control information, refer to the job control 
user guide. 
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7.3. PROGRAM CONSIDERATIONS 


In addition to issuing the proper job control statements, you must make certain 
specifications within your program to indicate that a screen format is being used. These 
specifications are relatively simple and specifically related to the language in which the 
program is written. 


7.3.1. RPG Il 


Considerations for an RPG Il program using screen formats relate to the following 
specifications forms: file, input, and output. 


File Specifications Form 


On this form, you must specify the workstation terminal as a primary file or a 
demand file. The block length is always omitted, and the device name (columns 
40-46) must be entered as WORKSTN. You must also specify other files used by 
the program (excluding the format library file); however, you may not designate any 
of these as secondary files if the workstation file is the primary file. 


Input Format Specifications Form 


RPG Il initializes the workstation program by generating a blank record. This record 
must be anticipated on the input format specifications form. 


Every variable data field with an I/O direction of input or both input and output 
(bidirectional) must be identified on the input format specifications form. The field 
names need not correspond to those that were assigned to the actual format fields 
during generation. 


The field location entries on the RPG II form refer to the position of these fields 
with respect to the input data rather than to the position of the input fields on the 
screen. This is simply because data is either read from the format (from input or 
bidirectional fields) or written to the format (to output or bidirectional fields) 
automatically - according to the sequence in which the variable data fields were 
described when the format was created. 


Field lengths are counted sequentially. The FROM entry for the first input or 
bidirectional field is always 1, and the TO entry is always the number of the last 
underline in the field as defined in the format. The FROM entry for the next field 
picks up where the TO entry for the previous field left off. The underlines are 
counted in relation to this number to get the TO entry. 
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Let’s say that the first input or bidirectional field in the format has a length of 10, @ 
and the second has a length of 12. The FROM and TO entries for the first field are 

1 and 10. Entries for the second field are therefore 11 and 22. Output fields are 

not counted at all. If an output field is located between two input or bidirectional 

fields, simply bypass it. 


Control levels, matching fields, and look-ahead fields may not be used with 
workstation input. 


s Output Format Specifications Form 


Every variable data field with an I/O direction of output or bidirectional must be 
identified on the output format specifications form. This includes any bidirectional 
field that was defined on the input format specifications form. 


The END POSITION entries refer to the end positions within the output data and 
not to their positions on the screen. For example, if there are two output or 
bidirectional fields with lengths of 10 and 12 respectively, the end position for the 
first field is 10, and that of the second field is 22. 


The name of the format, as it was specified on the home screen, must be entered 
in the CONSTANT OR EDIT WORD field (columns 45-52) and enclosed in 
apostrophes. The length of the format name must be entered in column 43 with 
the letter K preceding it (column 42). 





Use of a first-page indicator is not permitted. 


Figure 7-1 gives examples of screen formats and the accompanying input/output 
specifications that must be made for each format. 
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Input form 





© Figure 7-1. Screen Formats and Accompanying RPG Il Specifications (Part 1 of 2) 
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d. Output form 


Figure 7-1. Screen Formats and Accompanying RPG Il Specifications (Part 2 of 2) 
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@ Figure 7-1 is analyzed as follows. 
m Display 1 


The screen format showing the FROM and TO positions as they relate to the length 
of every input and bidirectional field. 


= = ~§=6The Input Format Specifications Form 
The input specifications showing field locations (lengths) for all input and 


bidirectional fields. The corresponding field names do not match the SFG-assigned 
field names. 


ws Display 2 


The screen format showing the end positions for every output and bidirectional 
field in the format. 


m= = The Output Format Specifications Form 


The output specifications showing the end position (length) of every output and 
bidirectional format field and the format name. Field names are not SFG-assigned. 


@ vores: 


1. The entries that appear on the RPG II forms in Figure 7-1 pertain only to the format 
data fields. Likewise, the terms input, output, and bidirectional refer only to the 
direction in which the data will flow between the program and the format. Files for 
the actual data (a master file, for example, containing names, addresses, etc) must 
be indicated by entries on the appropriate RPG Il forms. Also, I/O directions 
pertaining to data on these files may deviate from the I/O directions for the format. 
A new address, for example, may be input to the format, but at the same time it 
may serve as output to (update) a master. 


2. If during the format’s creation, editing for a numeric field involved use of the 
decimal point or a sign (+, -, etc), you must indicate the decimal places and signs 
for that field on the coding form. (See 2.3 for editing rules.) 


Refer to the RPG II user guide for general information on RPG Il programs. 


7.3.2. COBOL 

The following subsections explain: 

= The major COBOL coding conventions for using screen format services 
& w How to code for conditional indicators, based on these conventions 


m= How to code for function keys and multiple workstation users 
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7.3.2.1. Major Coding Considerations 


The major considerations for a COBOL program using screen formats relate to the 
following divisions: 


Environment division - SPECIAL NAMES paragraph 
Data division - working storage section 
Procedure division - ACCEPT and DISPLAY statements 
The basic considerations for each of these divisions are: 
@ = Environment Division 


The SPECIAL NAMES paragraph is used to associate screen format services with a 
workstation. The basic format for the actual statement is: 


SYSFORMAT IS mnemonic-name ASSIGN TO workstation lfd-name 


(Additional clauses associated with this format are discussed in 7.3.2.3.) 


The mnemonic-name is arbitrary, but the Ifd-name must match the name specified 
for the workstation in your job control DVC-LFD sequence as indicated by the 
following: 





DVC-LFD SEQUENCE FOR 
THE WORKSTATION 


// DVC 200 
// USE SFS 
// LFD WORKSTN 


THE SPECIAL NAMES STATEMENT 


SYSFORMAT IS mnemonic-name ASSIGN TO WORKSTN 


a Data Division 


You may define an area in the working storage section that will be used to hold 
input data from the format supplied by the workstation operator and output data & 
from the COBOL program to be displayed on the format. 
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e The data structures you define need not have the same names as those that were 
assigned to the fields during the format’s generation. Picture clauses associated 
with the data structures should, however, correspond to the field lengths and type 
attributes that were assigned via passes 1 and 2 of the SFG session. Assumed 
decimal places (v) and signs (s) should be specified wherever applicable. In 
addition, if the data’s internal usage is going to be packed, for example, this should 
also be indicated via the appropriate USAGE clause (USAGE COMP-3). 


m= Procedure Division 
Input and output activity between the program and a screen format results from the 
issuance of DISPLAY or ACCEPT statements in the COBOL program's procedure 
division. 
- DISPLAY Statement 
Used to display data from the program as output on the screen format 


- ACCEPT Statement 


Used to accept any input data supplied to the format by a workstation 


operator 
&@ The basic formats for both statements are as follows: 
panera Crete Ghowe ee a hal mnemonic-name 
literal -1 Literal-2 
ie ee 
literal 


ACCEPT identifier-1 [,identifier-2,...]FROM mnemonic-name 


[ene pea tid | 
literal 


(Additional clauses associated with these statements are discussed in 7.3.2.3.) 


The identifiers following the verb DISPLAY or ACCEPT are either group item names 
or elementary item names for the format’s input/output data structure as defined in 
working storage. As many identifiers as necessary may be listed after the first 
identifier. Literals, instead of identifiers, may be used with DISPLAY. 


The mnemonic name associated with UPON must be the one specified in the 
SPECIAL NAMES statement. 


If specified, the identifier or nonnumeric literal associated with the USING clause is 
a 1- to 8-character format name (as defined on the home screen). USING is 
required in only two cases. It is needed to specify the first screen format to be 

@ displayed at the workstation if you do not specify the initial-screen parameter in the 
// USE SFS job control statement. It is also needed to specify a forrnat change in a 
program using more than one format. In either case, once you specify USING for a 
particular format, you can, but need not, specify it for subsequent transactions 
(ACCEPTs or DISPLAYs) with the same format. 
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The issuance of the first DISPLAY statement for a particular format results in the 
following: 


— The screen format (named on the USE SFS job control statement after the 
USING clause) is automatically displayed on the workstation screen. 


- The data indicated by the DISPLAY verb is displayed in the appropriate (output 
or bidirectional) fields of the format. 


As a general rule, a given screen format must be displayed upon before it can be 
accepted from. This is true both for the initial screen format display and every time 
there is a visible change to that format on the workstation. An exception to this 
rule occurs when a screen format has no variable output data (if, for example, the 
format is being used strictly for input). In this case, either an ACCEPT or a 
DISPLAY statement may be the first transaction with a screen format. 


With both ACCEPT and DISPLAY, it is mandatory that the number of characters 
transmitted equal or exceed the total number of characters expected by the screen 
format (the format size). In other words, there is no provision for selectively 
reading from or writing to only some of the format’s fields. You may not, for 
example, display identifier 1, identifier 2 ... and not identifiers 3, 4, and 5 if these, 
as elementary (O02) items in working storage, describe three of the format’s output 
fields. 


- Displaying 
If the total number of characters to be displayed exceeds the format size, 
excess characters will be truncated. If the number of characters to be 
displayed is smaller than the format size, a run-time error will result. 

- Accepting 
If the number of characters to be accepted exceeds the format size, trailing 
blanks are supplied (to the program) to satisfy the request of the ACCEPT 


statement. 


If the number of characters accepted is less than the format size, a run-time 
error results. 


Consider the screen format in Figure 7-2. 


au rWN = 


SALES STATUS 
SALESMAN: 





Figure 7-2. Sample SCREENO1 
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@ The field characteristics as defined during creation of the format are: 


SALESMAN Alphabetic 






Numeric 


FL00000% Display 


Numeric 


The format name, as defined on the home screen, is SCREENO1 and it resides on the 
$Y$FMT library. The DVC-LFD sequence for the workstation must be included in the job 
control stream to execute a program using this format. 


// JOB SALES 


// DVC 200 
// USE SFS 
// LFD WORKSTN 


// EXEC SUMMARY 


Figure 7-3 shows COBOL program entries associated with SCREENO1 as they relate to 
the environment, data, and procedure divisions. 
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ENVIRONMENT DIVISION. 


SPECIAL NAMES 
(1) SYSFORMAT IS SCREENS ASSIGN TO WORKSTN. 


DATA DIVISION. 


WORKING-STORAGE SECTION. 


01 


OUTAREA 
@2 ITEM 


(2){@2 QUANTITY 
02 COMMISSION PICTURE 9(5)V99. (4) 


01 


INAREA 
@2 SALESMAN 


Oba ITEM 
@2 QUANTITY 


PROCEDURE DIVISION. 


(9) DISPLAY ITEM OF OUTAREA, QUANTITY OF OUTAREA COMMISSION 


PICTURE 9(7). 
PICTURE 9(5) USAGE COMP -3. (3) 


PICTURE 9(20). 
PICTURE A(7). 
PICTURE 9(5) USAGE COMP-3. 


© @ 


DISPLAY OUTAREA UPON SCREENS USING SCREENO1. 


UPON SCREENS. 


ACCEPT INAREA FROM SCREENS. 


FROM SCREENS. 


Figure 7-3. 


ACCEPT SALESMAN, ITEM OF INAREA,QUANTITY OF INAREA 


COBOL Program Entries for SCREENO1 (Part 1 of 2) 
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NOTES: 


QOQ © ©OOf O 


©© 


SPECIAL NAMES paragraph specifying SCREENS as the mnemonic name and WORKSTN as the [fd-name 
assigned via JCL for the workstation. 


Data names can, but do not have to, match the names assigned to the format’s fields during creation. 
Field was specified as packed during creation (dialog screen |}; therefore, USAGE is indicated. 


Editing was specified, via the type attribute screen, for this numeric field during generation of the format. 
Only the assumed decimal place should be indicated here. 


The format fields corresponding to these two items (ITEM and QTYSOLD) were specified with an 1/O 
direction of B (for both input and output, or bidirectional). Both items must be specified in OUTAREA as 
well as INAREA. The item names may be the same, as shown here, or different. 


DISPLAY verb may use the group item name. 
SCREENS is the mnemonic name used in the SYSFORMAT IS statement. 


The USING clause specifies the first format to be used by the program. (The initial-screen parameter was not 
specified in the // USE SFS job control statement.) USING is not necessary, but can be specified, in subsequent 
DISPLAY or ACCEPT statements for the same format. 


This DISPLAY statement lists elementary item names as identifiers. 


ACCEPT statements showing both the group item and elementary item names as identifiers. 


Figure 7-3. COBOL Program Entries for SCREENO1 (Part 2 of 2) 


In this example, only one format is being used with the program. As many formats as 
desired may be used, however, as long as the appropriate entries are made in the data 
division and all DISPLAY and ACCEPT statements reference the proper format name in 
the USING clause. 


You may not, in either the ACCEPT or DISPLAY statement, selectively list identifiers. 
The following would cause a run-time error since the format is expecting to receive 
output data for the field COMMISSION as well as [TEM and QUANTITY: 


DISPLAY ITEM,QUANTITY UPON SCREENS USING SCREENO1 


Since the O2 data division declarations for bidirectional fields may have the same 
INAREA as well as OUTAREA names (ITEM and QUANTITY), you are provided with an 
opportunity to specify the following or similar operations in the procedure division: 


B 

12 

DISPLAY OUTAREA UPON SCREENS USING SCREENO1. 
ACCEPT INAREA FROM SCREENS USING SCREEN®O1. 
MOVE CORRESPONDING INAREA TO OUTAREA. 
DISPLAY OUTAREA UPON SCREENS USING SCREENO1. 
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Consider now the format in Figure 7-4. 


PERSONAL CREDIT REPORT 


PAST DUE AMOUNT:$__ 
PAYMENT DUE:$__ 
NEW BALANCE:$__ 
ACCOUNT STATUS: 





Figure 7-4. Sample SCREENO2 


The field characteristics as defined during creation are: 


pe [eer tee] = 
Name Usage Usage Length 

ae ae et eee 
Frcoass | wow | omy | 0 | Were 
Teast | ouput | oephy | 7 | Niner 
Fearoue | roe | ovo | 7 | wine 
Prewsn | owna | oay | 7 | wimaie 


FLDOOO007 Display p25 | Alphanumeric 


The format name as defined on the home screen is SCREENO2, and it resides on the 
$Y$FMT library. The DVC-LFD sequence for the workstation is: 
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@ // JOB CREDIT 


// DVC 200 
// USE SFS 
// LFD WORKSTN 


// EXEC REPORTS 


Figure 7-5 shows COBOL program entries that relate to the environment and data 
divisions. 


A B 
8 12 
ENVIRONMENT DIVISION. 








SPECIAL NAMES. 
SYSFORMAT IS FORMATFL ASSIGN TO WORKSTN 


DATA DIVISION. 


WORKING-STORAGE SECTION. 


77 ~=INACTIVE PIC X(25) VALUE ‘ACCOUNT INACTIVE’. 
77 OVERDUE PIC X(25) VALUE ‘ACCOUNT OVERDUE'. 
@1 OUTAREA. 

@2 ADDR PIC X(30). 

@2 PAST-AMT PIC 9(5)V99. 

@2 NEW-BAL PIC 9(5)V99. 

@2 ACCNT-STATUS PIC X(25) VALUE SPACES. 
@1 INAREA. 

@2 NAME PIC (25). 

@2 ADDR PIC X(30). 

@2 ACCNT-NUM PIC 9(9). 

@2 PAYMT-DUE PIC 9(5)V99. 





@ Figure 7-5. COBOL Program Entries for SCREENO2 
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In this example, the utility of being able to list several identifiers in a single ACCEPT or 
DISPLAY statement can easily be demonstrated. If, for example, you want the literal 
‘ACCOUNT INACTIVE’ to be displayed as output in the ACCOUNT STATUS field 
(FLDOOOO7 as defined by the SFG and ACCNT-STATUS as_ described in 
working-storage) on the format, you simply issue the following statement in the 
procedure division: , 


DISPLAY ADDR,PAST-AMT,NEW-BAL, INACTIVE UPON FORMATFL USING SCREEN@2. 


If you don’t want to display anything for ACCOUNT STATUS on the format, you simply 
use: 


DISPLAY OUTAREA UPON FORMATFL USING SCREEN@2. 


You may not, however, use: 


DISPLAY ADDR,PAST-AMT,NEW-BAL UPON FORMATFL USING SCREEN@2. 


Refer to the 1974 ANSI COBOL programmer reference for more information concerning 
COBOL programming in general. 


7.3.2.2. Using Indicators 
You can specify two types of indicators when creating a screen format: 
1. Option indicators 


These affect the physical characteristics of your screen format at run time. They 
are output from your program to the screen format coordinator. 


2. Response indicators 


These are the indicators associated with function keys. They are input from the 
screen format to your program. (Function key indicators require additional coding 
that option indicators do not require. See 7.3.2.3 for details.) 


For indicators to work, you must define them in your program and send their values to 
the SFC. You do this the same way that you define and send data to output fields or 
accept data from input fields on a screen format (as discussed in the previous 
subsection). First you define indicator fields in the WORKING-STORAGE SECTION. For 
option indicators, you use the DISPLAY statement to pass indicator field data to the 
SFC. For response indicators, you use the ACCEPT statement to pass a value from the 
screen format to your program. 


When you organize the WORKING-STORAGE SECTION of your program, follow these 
guidelines: 
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= = =6The area where you define option indicator fields must precede the area where you 
define output data fields. The indicator field area can be part of a group that 
includes the output data fields. 


m The area where you define response indicator fields must precede the area where 
you define input data fields. The response indicator area can also be a part of a 
group that includes the input data fields. 


Option indicator fields must be made a part of the DISPLAY statement along with the 
output data fields. Similarly, response indicator fields must be made a part of the 
ACCEPT statement, along with the input data fields. Where indicators are used, the SFC 
automatically expects the leading bytes from a DISPLAY or an ACCEPT operation to be 
indicators. 

The following example illustrates how to handle indicators in your program. 


Once again, consider the format shown in Figure 7-2: 


SALES STATUS 


COMMISSION: $_ _,_ _ _-= _ 





This time, suppose the format was created with option indicators 10 and 20 and 
response indicator 30. (To keep this explanation brief and easy to follow, the functions 
performed by the indicators are not discussed.) One way of defining the indicators, 
turning them on, and identifying them to the SFC is shown in Figure 7-6. 
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ENVIRONMENT DIVISION. 


SPECIAL NAMES. 


SYSFORMAT IS SCREENS ASSIGN TO WORKSTN. 


DATA DIVISION. 


WORKING STORAGE SECTION. 
@1 OUTAREA. 
@2 INDICATOR-REGION 
@3 IND-16 PICTURE 
63 IND-20 PICTURE 
DATA-REGION 
@3 ITEM PICTURE 
03 QUANTITY PICTURE 
63 COMMISSION PICTURE 
INAREA. 
@2 INDICATOR-AREA-IN. 
@3 IND-30 PICTURE 
@2 DATA-REGION-IN. 





9. 
9. 


9(7). 
9(5) USAGE IS COMP-3. 
9(5)V99. 





9. 


@2 SALESMAN PICTURE 9(20@). 
@2 ITEM PICTURE A(7). 
@2 QUANTITY PICTURE 9(5) USAGE IS COMP-3. 


PROCEDURE DIVISION. 


MOVE 1 TO IND-160. (2) 


DISPLAY OUTAREA UPON SCREENS USING SCREENO1. (3) 


MOVE 1 TO IND-20. 


DISPLAY IND-1@,IND-20,1TEM,QUANTITY,COMMISSION UPON SCREENS USING SCREEN@1. 


ACCEPT INAREA FROM SCREENS USING SCREENO1. (5) 








Figure 7-6. COBOL Program Entries for Indicators (Part 1 of 2) 
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Here, the indicators are grouped with the output data fields. Since the format was created with indicators, the SFC 
knows that the first several bytes of OUTAREA are going to be indicator fields, not data fields. 


A simple MOVE statement is one way of turning an indicator on or off. An indicator is on when it contains the 
value of 1 and it is off when the value is 0. Although not shown in the example, you must remember to set an 
indicator value back to O to turn an indicator off. 


Here the DISPLAY verb uses the group name OUTAREA, thus passing both the indicator region and the data 
region to the SFC. Only the data fields appear on the workstation operator's screen. 


Here, instead of using the group name OUTAREA, the elementary items are listed in the DISPLAY statement. The 
result, however, is the same. The rules discussed in 7.3.2.2 regarding the DISPLAY verb also apply when 
indicators are used. 


@ <@:-@: 7) © 


The field for the response indicator IND-30 is included in the ACCEPT statement. If an operator presses the 
user-assigned function key associated with that indicator, a value of 1 is passed back to the indicator field, setting 
the indicator on. 


Figure 7-6. COBOL Program Entries for Indicators (Part 2 of 2) 


7.3.2.3. Additional Coding Considerations for Function Keys and Multivolume 
Workstations 


As noted previously, the SPECIAL NAMES paragraph and the ACCEPT and DISPLAY 

verbs have additional clauses not yet discussed. These additional clauses report 

function key input to a COBOL program and support multivolume workstations (where 
& several terminals operate under the same Ifd name). 


The complete statement for the SPECIAL NAMES paragraph is: 


SYSFORMAT IS mnemonic-name ASSIGN TO workstation lLfd-name 
CCONTROL AREA IS record-name] [WITH FUNCTION-KEYS] [WITH CONNECT-FREE] 


The CONTROL AREA clause specifies a 40-character area that receives data describing 
workstation activity. Among the benefits of having a control area are: 


™ ~§©Providing a better means of recovery when an error occurs. This is especially useful 
in a multiple-workstation environment. If your program encounters a problem with 
one workstation, it can be directed to handle the problem without affecting the 
other workstations connected to it. 


= Reporting when a workstation is connected to or freed from your program and 
directing your program to follow a course of action as a result. 


m Reporting function/command key input. You can direct your program to perform 
some operation when a_ workstation operator presses a_ user-assigned 
function/command key. 


The control area can be defined in the WORKING-STORAGE or LINKAGE sections of 
@ your program. You code the control area as follows: 
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@1 WRKSTN-CONTROL. 


05 
05 
05 
05 
05 
@5 
@5 
05 


a WRKST 


ws WS-ID 


WS-ID PIC 999. 
FILLER PIC X. 
WS-STATUS PIC XX. 
FUNCTION-KEY PIC 99. 
FORMAT - NAME PIC X¢8). 
NUMBER - CONNECTED PIC 99. 
SIZE-OF-DATA TRANSFER PIC 9(5). 
FILLER PIC X(17). 


N-CONTROL is a sample record name for the control area. 





7-22 


identifies the workstation where the most recent ACCEPT or DISPLAY 
operation was performed. 


WS-STATUS reports a 2-character status code for the workstation that performed 


the most recent ACCEPT or DISPLAY. Status code details are listed in Table 7-1. 


Table 7-1. Status Keys 


Status Key 1 Status Key 2 


0 Successful completion 


















0 No further information 








1 At end 0 Function key 15 received 
6 Only active terminal has disconnected 
(Status key 98 may take precedence.) 


Invalid format Format not found 





4 Format constructed incorrectly 


Workstation exception Terminal not compatible with format 





Statement not compatible with format 
Data not compatible with format 
Data area not large enough for format 
Function key, no data 
New device connected, no data 
Device disconnected (freed), no data 


Device not connected 
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| FORMAT-NAME is the name of the screen format that is active on the workstation 
terminal that was the object of the most recent ACCEPT or DISPLAY. 


m FUNCTION-KEY holds the number (from 1 to 22) of the function key pressed by an 
operator prior to the most recent ACCEPT. It is set to zero instead of a function 
key whenever data is accepted. The FUNCTION-KEY field is maintained only if the 
WITH FUNCTION-KEYS phrase is specified. 


m SIZE-OF-DATA-TRANSFER holds the number of characters actually sent to or 
received from the workstation screen. On a DISPLAY or ACCEPT operation, this 
number reflects the number of characters required by the format. 


The WITH FUNCTION-KEYS clause specifies that whenever function key input is 
received on an ACCEPT verb, that function key value is reported to the control area. 


The WITH CONNECT-FREE clause specifies that your program is directed to a particular 
procedure (an EXCEPTION path that is described later) when a terminal connects to or 
disconnects from your program. 


The complete format for the ACCEPT statement is: 


ACCEPT identifier-1 [,identifier-2...] 
FROM SPECIFIC mnemonic-name 


USING ieee eae 
Literal 


{ON EXCEPTION imperative-statement] 


SPECIFIC has meaning only for multivolume workstations. It indicates that input is to be 
accepted only from the particular workstation whose ID is given in WS-ID. If you use 
SPECIFIC, your program waits until the specified workstation supplies data, effectively 
locking out the other workstations. 


You should avoid including a USING clause in an ACCEPT statement when you're 
working with multivolume workstation files. Under such conditions, the object of the 
USING clause in an ACCEPT statement is always the workstation that performed the 
most recent ACCEPT or DISPLAY (the workstation identified by WS-ID in the control 
area). This means if you specify a particular format name in the USING clause, that 
format will appear on only one workstation — the one that performed the last DISPLAY 
or ACCEPT. As a result, the workstation (and corresponding format) supplying the data 
for the ACCEPT statement may be different from the format (and corresponding 
workstation) specified by the USING clause. 


The ON EXCEPTION clause directs your program to follow a different path whenever 
certain conditions arise, such as: 


mw = When certain errors occur 
m lf a workstation is connected to or freed from your program 


= When a user-assigned function key is pressed (This does not include function keys 
associated with a response indicator.) 
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If you specify a control area, you must include the ON EXCEPTION clause in both the 
ACCEPT and DISPLAY statements. If you do not specify a control area, you cannot use 
the ON EXCEPTION clause. 


The ON EXCEPTION clause lets your COBOL program diagnose and recover from errors 
that occur as a result of communication between the program and the workstation. 
When an error occurs, the nature of the problem is reported in the WS-STATUS field of 
the control area as a 2-digit status code. Your program is directed to follow an 
exception path that you define. For example, consider the following: 


ACCEPT INAREA FROM SCREENS USING SCREENQ1 
ON EXCEPTION PERFORM DIAGNOSIS-ROUTINE. 


If an operator enters data that is not compatible with the active screen format, the 
status code 93 (Table 7-1) is reported to the WS-STATUS field of the control area. 
The ON EXCEPTION path is activated and the DIAGNOSIS-ROUTINE is performed. The 
DIAGNOSIS-ROUTINE could prompt some corrective action to be taken, as follows: 


DIAGNOSIS-ROUTINE. 
IF WS-STATUS = 93 
PERFORM BAIL-OUT. 


You can code procedures for the various status codes listed in Table 7-1, including 
procedures to follow when a workstation is connected to or freed from your program. 
As long as you include the CONNECT-FREE clause in the SYSFORMAT statement, each 
time a workstation connects to or is freed from your program, a status code is reported | 
in the WS-STATUS field and an exception path is activated. Table 7-2 summarizes the 
effects of connect/free reporting. 


Table 7-2. Effects of Connect-Free Reporting 


Response to Connect or Free 


Set WS-STATUS to 97 or 98. 
Set WS-ID to report the device that connected or freed. 
Update NUMBER-CONNECTED. 
Execute the EXCEPTION clause. 











Workstation Options 










CONTROL AREA WITH 
CONNECT /FREE 

















CONTROL AREA 
without CONNECT /FREE 


Update NUMBER-CONNECTED. 
lf NUMBER-CONNECTED = 0, set status for end-of-file and execute the 
EXCEPTION clause. 

Otherwise, do not return contro! to the COBOL program until data is received. 


If no terminal remains connected, terminate the program abnormally. 
Otherwise, do not return control to the COBOL program until data is received. 


A user-assigned function key can also activate an exception path as long as no 
response indicator is associated with it. When an operator presses a user-assigned 
function key, the function key value is reported in the FUNCTION-KEY field, status code 
95 is returned to the WS-STATUS field, and the ON EXCEPTION clause is activated. 






CONTROL AREA not 
specified 
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For example, suppose you want your own help screen displayed whenever function key 
5 is pressed. As long as you've specified a CONTROL AREA and the WITH 
FUNCTION-KEYS clause, you can code your program as follows: 


ACCEPT INAREA FROM SCREENS USING SCREENO1 
ON EXCEPTION PERFORM DIAGNOSIS-ROUTINE 


DIAGNOSIS-ROUTINE. 
IF WS-STATUS = 95 PERFORM PROCESS -FUNCTION-KEY. 


PROCESS -FUNCTION-KEY. 
IF FUNCTION-KEY = 5 
PERFORM DISPLAY-HELP 


If a function key is associated with a response indicator, the exception path is not 
activated. Only the function key number is returned to the FUNCTION-KEYS field of the 
control area. You must code your program to test for the value returned in the 
response indicator field and then direct your program to perform a specific function. 


Table 7-3 summarizes the effects of function key input. 
Table 7-3. Effects of Function Key Reporting 


Response to Function Key Input 
Workstation 


Options Response Indicator Set 
by Function Key 


Response Indicators 
Absent or Unaffected 


CONTROL AREA with 
WITH FUNCTION-KEYS 


Return indicators without Set FUNCTION-KEY. 
screen data. Activate the EXCEPTION 
Set FUNCTION-KEY. clause. 

Do not activate the 

EXCEPTION clause. 


CONTROL AREA 
without WITH 
FUNCTION-KEYS 


CONTROL AREA not 
specified 


Return indicators 
without screen data. 
Do not set 
FUNCTION-KEY. 

Do not activate the 
EXCEPTION clause. 


Return indicators 
without screen data. 


Ignore the function key 
input. 

Do not return control 
to the COBOL program 
until data is received. 


Ignore the function key 
input. 

Do not return control 
to the COBOL program 
until data is received. 
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The complete format for the DISPLAY verb is: 


DISPLAY identifier-1 [identifier-2]... 
UPON mnemonic -name 
bea identifier-3 ] 
eee 
[ON EXCEPTION imperative-statement] 


The EXCEPTION clause for the DISPLAY statement performs most of the same 
functions as it does for the ACCEPT statement. It directs your program to follow an 
alternate path if certain errors occur when data is sent out to a screen format at a 
particular workstation. 


Refer to the 1974 ANSI COBOL programmer reference for more information concerning 
COBOL programming in general. 


7.3.2.4. Considerations for Workstations with Interprogram Communication 


When you combine separately compiled COBOL programs to form a single run unit and 
to interact with the same workstation, these guidelines apply: 


u In all programs, the SYSFORMAT IS statements should be identical except for the 
mnemonic-name, which is local to each program. While most workstation functions 
will still behave correctly if the SYSFORMAT statements aren’t identical, function 
key input and connect-free events may occur without being reported to the COBOL 
program. 





m You should establish a CONTROL AREA in the main program, reference it in the 
LINKAGE SECTION of the subprograms, and include it as an operand in the USING 
clause in CALL statements. 


7.3.3. FORTRAN 

Screen format services is activated by the FORTRAN system whenever the 
SCREEN=name option occurs in the sequential READ or WRITE statement as shown in 
the following examples: 


READ (20,100,SCREEN='TESTSCR1')I 








2. REAL*8 NAME/'TESTSCR2'/ 

WRITE (20,200,SCREEN=NAME ) 
The unit argument must be connected to a workstation device, and the screen name & 
specified by the literal or variable after ‘SCREEN=‘ must be the 1- to 8-character name 


that was assigned to the format (via the home screen) when it was created. 
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In cases where a format is used for both input and output, the screen name must be 
specified in the first WRITE statement to create the output fields. The same screen 
name must then be specified in a READ statement. 


Both formatted and unformatted |/O is permitted for a screen format. 


gs Formatted |/O 


Each screen field must be defined with DISPLAY. The field lengths must exactly 
match the lengths of the actual screen format fields as specified during the SFG 
session. The following example requires that “‘TESTSCR1° have a 3-character input 
display field: 


READ (20,100,SCREEN='TESTSCR1' )I 
10@ FORMAT (13) 








UP-8802 Rev. 2 SPERRY UNIVAC OS/3 7-27 
SCREEN FORMAT SERVICES 











= Unformatted I/O 


Unformatted I/O is only permitted for characters and integers. Logical and real 
values are restricted. The internal lengths defined for the screen format must match 
the FORTRAN data sizes. 


Y 
N 
3) 


Data 





INTEGER 
REAL 

REAL*8 
LOGICAL 
INTEGER*2 
LOGICAL*1 
COMPLEX 
COMPLEX* 16 


MO-NAHAOALH 


eel 


Refer to the FORTRAN IV programmer reference for more information concerning 
FORTRAN IV programming in general. 


7.3.4. BAL 


The imperative macroinstructions associated with using screen format services are 
OPEN, CLOSE, DMSEL (SELECT), DMINP (INPUT), and DMOUT (OUTPUT). 


7.3.4.1. Open a File (OPEN) 


You use this macroinstruction to initialize a file. This instruction establishes a logical 
access path (LAP) to the physical file. Only one file can be opened when you issue this 
instruction. If you want to access more than one file, you must issue an OPEN 
instruction for each of the files. You must issue this instruction for a file before you 
attempt any processing. 


Format: 


LABEL AOPERATIONA OPERAND 


cdibname ,{ (ribname) 

(1) (@) 

4 (1) 
cdibname 


is the symbolic address of the CDIB that contains the screen name that was 
assigned to the file by the LFD job control statement. 






Positional Parameter 1: 


(1) or 1 
Indicates that you have preloaded register 1 with the address of the CDIB for 
the file to be opened. 
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Positional Parameter 2: 


ribname 
Is the symbolic address of the RIB associated with the file to be opened. 


(9) or @ 
Indicates that you have preloaded register O with the address of the RIB 
associated with the file. If you load register O with a value of zero, this 
indicates that there is no RIB associated with the file. (This also means that a 
RIB cannot resider at relative address X'O000000’.) 


If a symbolic address is specified for both positional parameter 1 and 
positional parameter 2, the comma shown in the instruction format is optional. 


Example: 


OPEN FILE1 RIB1 


7.3.4.2. Close a File (CLOSE) 


You use this macroinstruction to terminate file processing. Once a file is closed, it 
cannot be accessed until it is reopened by issuing an OPEN macroinstruction. Only one 
file can be closed when you issue this instruction. If you have more than one file open 
in your program, you must issue a CLOSE instruction for each of the files. 


Format: 


LABEL AOPERATIONA 





OPERAND 


cdibname 
ft | 


1 










Positional Parameter 1: 


cdibname 


Is the symbolic address of the CDIB that contains the screen name that was 
assigned to the file by the LFD job control statement. 


(1) or 1 


Indicates that you have preloaded register 1 with the address of the CDIB 
associated with the file to be closed. 


Example: 
1. | CLOSE SCREEN1 
2. | CLOSE 1 


1. The file whose CDIB has the symbolic address SCREEN 1 is to be closed. 


2. The file whose CDIB address has been preloaded into register 1 is to be 
closed. 
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@ 7.3.4.3. Retrieve a Record (DMINP) 
The DMINP imperative makes data from a device available to a user program within a 
work area. The work area must be large enough to handle all input that has been 
entered by the operator. If function keys entered set response indicators, the 
appropriate number of response indicators must precede the data in the work area. 


Format: 


LABEL AOPERATIONA OPERAND 

[name] DMINP {cdibname}, work area 
(0) 
() 


Positional Parameter 1: 








cdibname 
Specifies the logical file name that symbolically identifies the CBIB to be 
affected. 


(1) or 1 
@ Indicates that register 1 contains the address of the CDIB. 


Positional Parameter 2: 


work area 
Specifies the symbolic address of a work area that is to contain all response 
indicators and input data. 


(@) or @ 
Indicates that register O is the address of a work area. 


NOTES: 


1. You need not issue a DMSEL imperative prior to the first imperative if JCL 
specification was provided with an initial screen selection. 


2. If you issue the DMINP imperative without issuing the DMOUT imperative, screen 
format services issues a DMOUT imperative for the format in effect (whether 
specific or from JCL). All input fields are displayed with the replenish value. If any 
output or bidirectional fields exist, however, an error is returned and the DMOUT is 
not issued. 


3. If the input record size specified for variable-length records is not large enough, an 
error is returned and no read operation is issued. 


& 4. For variable-length records, the size of the variable data plus the number of 
response indicators plus 4 followed by two blanks is moved to the first two bytes 
of the work area. 


UP-8802 Rev. 2 
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m Error Codes Returned 2 & 





If the DMINP is unsuccessful, CDSDDINF+11 contains one of the following error 


codes: 


X'04' 


X‘05' 


X'06' 


X'07’ 


X'10' 


X11" 


X‘12' 


X‘13' 


X'14' 


X‘15' 


X'16' 


X17" 


X‘18" 


X19" 


Invalid input record size 

Output only screen format 

Output only device 

Invalid SFS imperative sequence 

Record level format error 

imperative abnormally terminated 

Field level format error 

DSD field level format error 

Undecipherable characters in the input buffer 


Physical I/O error 





INT-1 conversion error 
Maximum retries exceeded 
DSD syntax error 


Function key 16 entered 
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7.3.4.4. Select a Screen Format (DMSEL,SCREEN) 


You use the DMSEL,SCREEN imperative macroinstruction to indicate which screen 
format is to be displayed. 


Format: 
LABEL AOPERATIONA OPERAND 
[name] cdibname ),SCREEN, 
{en | 
1 


(0) 
6 





[io format mm 


Positional Parameter 1: 


cdibname 


Is the symbolic address of the CDIB that contains the name that was assigned 
to the file by the LFD job control statement. 


(1) or 1 
Indicates that you have preloaded register 1 with the address of the CDIB. 


Positional Parameter 2: 


SCREEN 
Indicates that you are selecting a screen format from a screen format file. 


Positional Parameter 3: 


screen format name 


Is the symbolic address of an 8-byte area that contains the name of the screen 
format to be selected. 


(9) or @ 


Indicates that you have preloaded the address of the screen format name in 
register O. 
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Example: 


DMSEL WORKSTN,SCREEN,S1 
Selects the screen format named in the 8-byte area $1. 
If the format name provided contains all X‘O0O', the effect is to terminate screen format 


services. If you subsequently issue a DMSEL with a format name, screen format 
services is reactivated. 


NOTE: 


Resetting screen format services is not permitted for a multiworkstation file. An invalid 
imperative error code is returned should an attempt be made to do so. 


m = «Error Conditions Returned (CD$DDINF + 1 1) 
X'21' Format name specified could not be found 
X'22' ~—1/0 error while reading the format 
X‘20' Format width greater than screen width 


X'11° Imperative abnormally terminated 
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7.3.4.5. Output a Record (DMOUT) 


The DMOUT imperative permits the user data to be merged from the user’s work area 


with a previously selected format, which is then presented to the device. The keyboard 
is also unlocked. 








Format: 
LABEL AOPERATIONA OPERAND 
cdibname,,,;work area 
[en | {co | 
1 0 
Positional Parameter 1: 
cdibname 
Specifies the logical file name that symbolically identifies the CDIB to be 
affected. 
(1) or 1 


Indicates that register 1 contains the address of the CDIB. 
Positional Parameter 2: 


work area 


Specifies a positional parameter defining a user work area that contains any 
option indicators and all fields to be merged with the format. 


(@) or @ 
Indicates register O points to the user’s work area. 


a Error conditions returned 


If the output record size specified for variable-length records is not large enough, an 
error will be returned and the partial buffer will not be sent. 


UP-8802 Rev. 2 SPERRY UNIVAC OS/3 7-34 
SCREEN FORMAT SERVICES 





m Error codes reported in CDS$DDINF+ 11 


X‘03 Invalid output record size 

X‘'08' 1/0 or INT-2 conversion error 
X‘09’ Invalid screen format 

X'11° Imperative abnormally terminated 


X‘26' Output verification error 


x'29' Device freed 


7.3.5. ESCORT 


When you create a screen format, you give ESCORT a special format in which to output 
file data. You still designate a structure, but instead of your file being output in the 
default structure format, it's linked with your screen format. When you designate a 
screen format, the fields you link to it must be identical to the fields contained in a 
structure. They must have the same name, and they must be in the same order as the 
corresponding fields in your structure. Both the format and your structure must also 
have the same number of fields. 


For example, if you designate 10 fields in a format and link it to a structure with only 9 
fields, you get an error because ESCORT keeps looking for the 10th field. 


It is possible, however, to have a structure with 10 fields and an output format using 
only 5 fields, but only the first 5 fields of your structure are output. Although you can 
do it this way, it’s always better to have a direct structure/format linkup to eliminate 
confusion. 


Depending on the type of ESCORT program you use with a format (ENTER DATA, 
CHANGE DATA, SELECT DATA), the following requirements apply: 


mw ENTER DATA 


Specify all fields in the format as input (I). 
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m CHANGE DATA 
Specify all fields in the format as both input and output (B). 
Protect the decimal point in decimal numbers with a slash. 


You cannot use packed decimal fields in a format. The initial display does not 
display underlines for the packed field. 


When the format is first displayed, only the key field is read. ESCORT ignores all 
other data until the master record is displayed and changed. 


m SELECT (display) DATA 
Specify all fields as both input and output (B) or as output only (O). When you 
display data using only output fields, you must define at least one input field to 
hold the screen until the XMIT key is pressed. ESCORT ignores any data sent from 
this input field (B or |). 

7.3.6. IMS Programming Considerations 

= ~§=General Considerations: 


- UNISCOPE 100 and 200 terminals must have the PROTECT feature. 


- UTS 400 terminals (if operating in native mode) must have the PROTECT 
feature; FCC switch set to FCC; and control page set to XMIT variable. 


- SFS parameter specifying the number of terminals that use screen formats at 
the same time. 


- RESFMT parameter indicating the maximum number of screen formats that 
remain resident between SFS calls. 


- CALL ‘BUILD’ and CALL/ZG#CALL BUILD commands call screen format 
services in COBOL and BAL action programs, respectively. A ‘‘K’’ in column 
42 of the output specifications forms calls screen format services in RPG II 
action programs. You must not specify the USE SFS job control statement. 


m = =RPG II Action Program Considerations: 

- Input Format Specifications Form 
Every variable data field with an |/O direction of input or both input and output 
(bidirectional) must be identified on the input format specifications form. The 


field names need not correspond to those that were assigned to the actual 
format fields during generation. 
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The field location entries on the RPG Il form refer to the position of these 
fields with respect to the input data rather than to the position of the input 
fields on the screen. This is simply because data is either read from the format 
(from input or bidirectional fields) or written to the format (to output or 
bidirectional fields) automatically - according to the squence in which the 
variable data fields were described when the format was created. 


Field lengths are counted sequentially. The FROM entry for the first input or 
bidirectional field is always 1, and the TO entry is always the number of the 
last underline in the field as defined in the format. The FROM entry for the next 
field picks up where the TO entry for the previous field left off. The underlines 
are counted in relation to this number to get the TO entry. 


Let’s say that the first input or bidirectional field in the format has a length of 
10, and the second has a length of 12. The FROM and TO entries for the first 
field are 1 and 10. Entries for the second field are therefore 11 and 22. Output 
fields are not counted at all. If an output field is located between two input or 
bidirectional fields, simply bypass it. 


Control levels, matching fields, and look-ahead fields may not be used with 
workstation input. 


- Qutput Format Specifications Form 


Every variable data field with an I/O direction of output or bidirectional must be 
identified on the output format specifications form. This includes any 
bidirectional field that was defined on the input format specifications form. 


The END POSITION entries refer to the end positions within the output data 
and not to their positions on the screen. For example, if there are two output 
or bidirectional fields with lengths of 10 and 12 respectively, the end position 
for the first field is 10, and that of the second field is 12. 


The name of the format, as it was specified on the home screen, must be 
entered in the CONSTANT OR EDIT WORD field (columns 45-52) and enclosed 
in apostrophes. The length of the format name must be entered in column 43 
with the letter K preceding it (column 42). 

Use of a first-page indicator is not permitted. 


w COBOL Action Programs 


The COBOL compiler does not interface with screen format services. All interfaces 
with screen format services are through IMS (CALL BUILD). 


@ BAL Action Programs 


Same as COBOL. 
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7.4. CONSIDERATIONS FOR THE WORKSTATION OPERATOR 


The following guidelines apply when you enter data on a screen format: 


After you enter data on a screen, make sure the cursor is beyond the last field of 
the format before transmitting. If you return to a particular field to correct an error 
before transmission, correct the error, position the cursor beyond the last field, and 
then transmit. 

If you return to a particular field to correct an error after transmission, simply 
correct the error and transmit. You don’t have to position the cursor beyond the 
last field. 

The following are function keys you should not use and operations you should not 
perform while a screen format is active. Disruption of device control information in 
the workstation and possibly termination of input transmission may occur. (An 
SF16 error results.) The restricted keys and operations are: 

— INSERT LINE 

— DELETE LINE 

— LINE DUP 

—- DISPLAY ERASE 

— FCC GEN 

— FCC CLEAR 

— FCC ENABLE 

— RESET 

— TAB SET (causes an SF14 error) 

— Changing the control page XMIT option to other than VAR 


— Switching to simulated system mode on a UNISCOPE terminal 


— Powering off the workstation 
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Appendix A. Job Control Considerations 


A.1. THE USE SFS STATEMENT 


You must indicate within the DVC/LFD sequence for the workstation that screen 
formats are to be used. This is done via the USE SFS job control statement. The 
optional positional parameters in this statement may be used as necessary. The format 
for the statement is: 








fee 


siecle | ha 
1 


[,screen-format-1=alias-1,...,screen-format-12=alias-12] 


//{symbol] USE SFS form Ne eas | 


where: 


SFS 
Indicates that the program is to use a screen format. 






[format-file-lfd-1]/[format-file-lfd-2] ] 
format-file-lfd 


in this parameter, you can provide an Ifd name for up two screen format files. 
Any name you use must match an Ifd name specified in a previously defined 
device assignment set for a screen format file. (Screen format files are always 
MIRAM files.) The format-file-Ifd is one to eight alphanumeric characters long. 


When coding this parameter, remember the following: 


= If you omit a format-file-lfd name, it is assumed that all screen formats 
used reside in the system file SY$FMT. 


m= If you code /format-file-lfd-2 alone, $Y$FMT is examined first then the file 
indicated by format-file-lfd-2. 
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If you code format-file-lfd-1/ alone, the file indicated by format-file-lfd-1 is 
examined first then $Y$FMT. 


If you code format-file-lfd alone, only the file indicated by format-file-Ifd is 
examined. 


If you specify format-file-ifd-1/format-file-lfd-2, a search will be made in 
format-file-lfd-1 first. If the format isn't found, format-file-lfd-2 will be 
searched. 


initial-screen 
The initial screen name refers to the 1- to 8-character name (as defined on the 
home screen) for a format. Use of this parameter depends on the program's 
language. 


BAL 


The initial screen name indicates the first format to be used by the 
program. A DMSEL imperative need not be issued to use this format as 
the initial format. Refer to 7.3.4 and the consolidated data management 
macro language user guide/programmer reference for further information 
on BAL macros. 


COBOL 


The initial screen name indicates the first format to be used by the 
program. 


Refer to 7.3.2 and the 1974 ANSI COBOL programmer reference for 
further information on the SYSFORMAT IS statement and the use of 
screen formats with a COBOL program. 


RPG Il 


This parameter should not be used with an RPG II program. Refer to 7.3.1 
and the RPG ll user guide for further discussion of RPG Il programming 
and screen formats. 


FORTRAN IV 


nnn 
vt} 


This parameter may be used with a FORTRAN program. Refer to 7.3.3 
and the FORTRAN IV programmer reference for more information on 
FORTRAN programming. 


This parameter indicates the number of formats to be present in main storage 
at any one time. It should only be used if the program is going to alternate 
regularly between two or more formats. The default for this parameter is 1, 
but you may specify any number from 2 to 255. The number of formats that 
the program uses is not limited to the number specified here. 


If you accept the default, regardless of how many formats a program is going 
to use, only one format will ever be present in main storage. When the first 
format is called by the program, it is placed in main storage. When the second 
is called, it replaces the first, and so on. 
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& The number 3 entered for this parameter indicates that three formats can 
reside in main storage throughout the program use. You might use this 
parameter when a program is constantly going to alternate between the same 
three formats. As a result, the !/O activity that would be necessary to bring 
the formats back and forth (if the default were accepted) is eliminated. By the 
same token, however, more main storage is used up to accommodate three 
formats. 


Remember, the number 3 does not restrict the program to the use of only 
three formats. It means that three formats can reside in main storage at once. 
If the program uses only three, the same three will always be present. If it 
uses more, which three formats are present depends on which ones the 
program calls and when. 


screen-format-1=alias-1,... 
This parameter permits you to equate the name that was given to the format 
when it was created with a name that the program uses for that format. 
Suppose SCREENO1 was the name specified on the home screen during 
generation. Supplying the alias parameter as SCREENO1=MYSCREEN means 
that the program is using the name MYSCREEN instead of SCREENO1. No 
more than 12 alias names may be specified. 


© The following is an example of the USE statement with some accompanying 
parameters. \ 


// USE SFS,FORMFIL,,2,SCREEN®@2=MYSCREEN 


This statement indicates: 


- The formats to be used are on a library file other than SYS$FMT. The lfd-name for 
that file is FORMEFIL. 


- Two formats will reside in main storage. 


- The program will use the name MYSCREEN when referencing SCREENO2. 


The following are some examples of job control DVC/LFD sequences containing the 
USE SFS statement. 
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Example 1: 


// JOB PAYROL 


// DVC 200 DVC/LFD sequence 
// USE SFS for the workstation 
// LFD WRKSTN file 


// EXEC PRSNL 


Example 2: 


// JOB PAYROL 


// DVC 200 DVC/LFD 


// USE SFS,,,,SCREEN®@2=MYSCREEN sequence 

// LFD WRKSTN for the 
workstation 
file 


// EXEC PRSNL 


Both of these examples contain a DVC/LFD sequence for the workstation where the 
device code number is 200 and the name that the program will use to reference the 
workstation is WRKSTN. In both cases, the formats to be used are on $Y$FMT; 
therefore, no LFD/DVC sequence is given for this file and the USE statement does not 
specify a format’s file Ifd name. The USE statement in example 2 specifies the alias 
parameter. 
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& Now consider these examples: 
Example 1: 


// JOB PAYROL 


// DVC 56 


DVC/LFD sequence 
// VOL DOO028 

for the user 
// LBL FORMFIL | | : 

library file 
// LFD SCRNS 
// DVC 200 DVC/LFD sequence 
// USE SFS,SCRNS 7 for the 
// LED WRKSTN workstation 


// EXEC PRSNL 


& Example 2: 


// JOB PAYROL 


// DVC 5@ 


DVC/LFD 
// VOL D00028 /LFD sequence 
for the user 
// LBL FORMIL |. 
library file 
// LFD SCRNS 
// DVC 200 avenee 
// USE SFS,SCRNS, ,39,SCRN@3=MYSCRN sequence 
// LFD WRKSTN for the 


workstation 


// EXEC PRSNL 


In both examples, the formats are stored on a user-assigned MIRAM library file; 
consequently, a DVC/LFD sequence for this file must be given. The USE SFS statement 
within the workstation DVC/LFD sequence must specify the Ifd-name for the user library 

& file as shown. The number of formats to be present in main storage at any one time is 
specified as 3. The alias parameter is also specified. For more information concerning 
job control in general, refer to the job control user guide. 
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A.2. JOB CONTROL FOR MULTIPLE WORKSTATIONS 


When building a job control stream for a job that uses screen formats, you may specify 
the use of more than one workstation. This allows several operators to work with a 
screen format at once. The following is an example of a job control stream that 
specifies multiple workstation use. 


Request for EDT LOGON MG2 
(the general editor) EDT 


// JOB SCREENIT 

// DVC 200(3),REQ(3) 
// USE SFS 

// UID WO1,WO2,WO3 
// LFD WORKSTN 


F : : DVC 51 
Device assignment 


Device assignment 
set (DVC/LFD 
sequence) for 

the workstation 


// VOL DOO0028 
// LBL LODLIBRARY 
// LFD LODLIB 


// DVC 52 

// VOL DOOG028 
// LBL INPAYROLL 
// LFD INPAY 


// DVC 52 

// VOL DO00028 

// LBL OUTPAYROLL 
// LFD OUTPAY 


// EXEC PAYROLL,LODLIB 
/& 
@WRITE MODULE=SCREENIT, FILENAME=SAVE JOBS, VSN=D000028 


@HALT 
LOGOFF 


set for the 
payroll program 


Device assignment 
set for the 

input data 

file 

Device assignment 
set for the 
output data 

file 


EDT commands 


The DVC for the workstation indicates that three workstations are to be used and that 
the job will not be scheduled until three workstations are available (as indicated by the 
REQ parameter). The UID statement provides three workstation user IDs. 


Although not directly related to the DVC and UID statements for multiple workstation 
use, there are some other items related to this job control stream worth mentioning. 


m When working with multiple workstations, you may include the FREE statement 
either within the job control stream or enter it directly at the workstation as a 
command to free one or more workstations when their use is no longer required. 











UP-8802 Rev. 2 SPERRY UNIVAC OS/3 A-7 
SCREEN FORMAT SERVICES 

















m As shown in the example, you may use the EDT, @WRITE, and @HALT commands 
so that the next time you want to run this job all you have to do is enter 


LOGON MG2 
RV SCREENIT, (SAVEJOBS ,D000028) 


at the workstation. 


= You must include the USE SFS statement (A.1) in the DVC/LFD sequence for the 
workstation whenever screen formats are used. 


m Since there is no DVC/LFD sequence for a screen format file, it is assumed that all 
formats are in the library $Y$FMT on SYSRES. 


For more information about job control, see the job control user guide. For more 
information about EDT, see the general editor user guide/programmer reference. 
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Appendix B. Help Screens 


& To be supplied 
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Appendix C. Function Keys 


The following function keys provide general assistance in using the SFG. 


Function key 1 

Aborts processing of the current function and returns you to the HOME SCREEN. 
Function key 5 

Causes the screen format generator to breakpoint the spool file to a printer. All 
records currently in the spooled printer output are directed to a printer (pending an 
available device). Records added to the spool file after the breakpoint are held until 
a subsequent breakpoint is requested or until the end of the job. 

Function key 13 

Requests help for the user. The SFG will display the appropriate procedures and 
rules that apply to the particular stage of format generation with which you are 
involved. Press function key 14 to terminate the help screen or press the XMIT key 
to receive additional HELP screens. 

Function key 14 

Returns you to normal processing after HELP is displayed. 

Function key 15 

Indicates end of input data. 

Function key 16 


Indicates input data cannot be entered properly. 


Function key 20 


Restores the screen to its original contents for the current pass if it has 
inadvertently been destroyed. If pressed during pass 1 or when you are using 
modify option 7 (CHANGE TEMPLATE ONLY — NO INTERNAL CHANGES), an 
SFG9O message (FUNCTION NOT SUPPORTED) appears. 
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Appendix D. Alphabet Table 


The following table indicates characters considered alphabetic in addition to A-Z, a-z, 
and the space character. 


Denmark and Norway 





& BS S PDO 


France 


Germany 


Sweden and Finland 





CO, MwO:o: CMP Or 
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Appendix E. SFS Support of 
Display Attributes 


Device 
Display 


Attribute UTS/20D UTS/40D c 
UTS/20 UTS/40 es 
Display Intensity: 


Normal Normal Normal Normal Normal 
intensity intensity intensity intensity 


Alternate Normal Low intensity Low /reverse/ Low intensity Dependent upon 
Brightness intensity normal (See control page 
comment.) setting 


Low Normal Low intensity Low/reverse/ Low intensity Dependent upon 
intensity normal (See control page 
comment.) setting 


Nondisplay Normal Nondisplay Normal Nondisplay 


intensity intensity 
Highlighting: 


Blink Blink Blink field Blink field Blink field Blink character 
character (See comment.) for Katakana 
UTS/20D & UTS/20 


Reverse Blink Blink field Blink field Reverse video Blink character 
video character for Katakana 
UTS/20D & UTS/20 
Emphasis: 
Underline Underline 


Strike thru Strike thru 


Column Column 
separator separator 
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Index 
Term Reference Page Term Reference Page 
A Alternate display properties Appendix E 
3.4.4 3-18 
A character 
indicating alphabetic fields 2.2 2-1 Asterisk (*) character 2.3.2 2-3 
indicating alphanumeric fields 2.2 2-2 
Attributes See type 
Action programs attributes. 
BAL 7.3.6 7-36 
COBOL 7.3.6 7-36 
© RPG Il 7.3.6 7-35 
Alphabet 
characteristics screen 3.3 3-5 
3.3.2 3-6 
English as default 3.3.2 3-6 
foreign characters Appendix D 
Alphabetic characters 
error message field 3.4.5 3-19 
foreign Appendix D 
lowercase 3.3.1 3-6 
uppercase 3.3.1 3-6 
Alphabetic fields 
default values for dialog screens 3.5.8 3-40 
editing 2.3.1 2-2 
4.1.2 4-5 B 
range checking 3.5.7 3-38 
rules 2.2 2-1 B (both), input and output 
type attributes 4.1.2 4-5 (bidirectional) fields 4.1.3 4-8 
variable data fields 1.3.2.2 1-9 
BAL 
Alphanumeric fields close a file (CLOSE) 7.3.4.2 7-28 
default values for dialog screens 3.5.8 3-40 imperative macroinstructions 7.3.4 7-27 
editing 2.3.1 2-2 open a file (OPEN) 7.3.4.1 7-27 
range checking 3.5.7 3-38 output a record (DMOUT) 7.3.4.5 7-33 
rules 2.2 2-2 retrieve a record (DMINP) 7.3.4.3 7-29 
© type attributes 4.12 4-5 select a screen format 
: variable data fields 1.3.2.2 1-9 (DMSEL,SCREEN) 7.3.4.4 7-31 
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Term Reference Page Term Reference Page 
Bidirectional fields Cc 
characteristics screen 3.3.9 3-10 
conditional display 3.5.3 3-33 CD$DDINF +11 error codes 
conditional protection 3.5.6 3-37 DMINP imperative macroinstruction 7.3.4.3 7-30 
conditional retention 3.5.5 3-37 DMOUT imperative macroinstruction 7.3.4.5 7-34 
dialog screen 3 3.5.3 3-33 DMSEL,SCREEN imperative 
dialog screen 4 3.5.4 3-35 macroinstruction 7.3.4.4 7-32 
dialog screen 5 3.5.5 3-36 
dialog screen 6 3.5.6 3-37 CHANGE 1/0 option 
display retention 3.3.9 3-10 modification summary 5.2 5-6 
display retention screen 3.4.6 3-21 modify screen 5.1.1 5-2 
ESCORT 7.3.5 7-35 5.1.1.3 5-4 
IMS 7.3.6 7-35 
list screen 6.1.2.6 6-7 CHANGE TEMPLATE ONLY - NO 
nondisplay screen 3.4.8 3-23 INTERNAL CHANGES option 
RPG Il 7.3.1 7-5 modification summary 5.2 5-6 
7.3.6 7-35 modify screen 5.1.1 5-2 
SHOW function 6.1.1 6-1 5.1.1.4 5-4 
specifying 1.3.2.2 1-10 
4.13 4-8 CHANGE TEMPLATE option 
See also 1/0 fields and variable modification summary 5.2 5-6 
data fields. modify screen 5.1.1 5-2 
5.11 5-3 
Blank character 
edit screen 3.4.3 3-17 CHANGE TYPE option 
editing alphabetic and modification summary 5.2 5-6 
alphanumeric fields 2.3.1 2-2 modify screen 5.1.1 5-2 
simple insertion in numeric 5.1.1.2 5-3 
fields 2.3.2 2-3 
Characteristics screen 
alphabet (line 3) 3.3.2 3-6 
creating new format 3.3 3-5 
4.3 4.2 
cursor positioning and overwriting 3.6 3-42 
display retention (line 9) 3.3.9 3-10 
erasing and unlocking options 
(lines 4 and 5) 3.3.4 3-7 
error message field (line 8) 3.3.8 3-10 
error retry counts (line 6) 3.3.5 3-8 
function keys (line 10) 3.3.10 3-10 
lowercase translation (line 2) 3.3.1 3-6 
nondisplayed field (line 11) 3.3.11 3-11 
original and overlay formats 
(line 3) 3.3.3 3-6 
prompting additional screens 3.3 3-5 
3.4 3-11 
related optional and dialog screens Table 3-1 3-11 
3.4 3-11 
3.5 3-24 
sample format 4.2.1.1 4-13 
special display control (line 7) 3.3.7 3-9 
special editing characters (line 6) 3.3.6 3-9 


CLOSE (close a file), BAL imperative 
macroinstruction 7.3.4.2 7-28 











@ Term 
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COBOL Conditional retention dialog 
connect-free reporting Table 7-2 7-24 (dialog screen 5) 3.5.5 3-36 
data division 7.3.2.1 - 
environment division 7.3.2.1 7-10 Conditional values screen 6.1.2 -2 
function key reporting Table 7-3 7-25 6.1.2.8 6-11 
function keys and multivolume 
workstations 7.3.2.3 7-21 CR character 
indicators 7.3.2.2 7-18 dialog screen 1 3.5.1 3-27 
interprogram communication editing rules for signed output 
considerations 7.3.2.4 7-26 fields Table 2-1 2-6 
major coding considerations 7.3.2.1 7-10 fixed insertion in numeric fields 2.3.2 2-3 
procedure division 7.3.2.1 7-11 
status keys Table 7-1 7-22 CREATE-FROM function 
characteristics screen 3.3.2 3-6 
Comma dialog screen 1 3.5:1 3-27 
dialog screen 1 3.5.1 3-29 home screen 3.2 3-1 
editing input or bidirectional 3.2.1 3-3 
fields 1.3.2.3 1-11 modifying formats 5.1 5-1 
protecting 3.5.1 3-30 5.2 5-6 
simple and fixed insertion in new format name 3.2.2 3-4 
numeric fields 2.3.2 2-3 old format name and library 3.2.3 3-4 
Command keys See function/ CREATE function 
command key basic screen format 4] 4-1 
screen. characteristics screen 3.3 3-5 
4 42 
Conditional display dialog complex screen format 4.2 4.10 
(dialog screen 3) 3.5.3 3-33 4.2.1 4-10 
dialog screens 3.5 3-24 
Conditional display properties dialog 42 4-10 
(dialog screen 4) 3.5.4 3-34 A217 4-17 
duplicate tines 44 4-24 
Conditional erase/replenish screen home screen 3.2 3-1 
characteristics screen Table 3-1 = 33-1 4.1 4-2 
3.42 = new format name and library 3.2.2 3-4 
sample format 4.2.1 4-10 optional screens 34 3-11 
4.2.1.2 4-13 4.2 4-10 
use 3.4 = original formats 3.3.3 3-6 
3.4.2 3-13 overlay formats 3.3.3 3-6 
43 4-20a 
Conditional indicators pass 1, basic format 4.1.1 4-3 
conditional values screen 6.1.2.8 6-11 pass 1, complex format 4.2.1.4 4-14 
dialog screens 3.4.1 3-12 pass 2, basic format 4.1.2 4-5 
35 3-24 pass 2, complex format 4.2.1.5 4-15 
display properties 3.5.4 3-34 pass 3, basic format 4.1.3 4-7 
erase 3.4.2 3-13 pass 3, complex format 42.1.6 4-16 
error message screen 3.4.5 3-20 screen format 3.2.1 3-2 
list. screen 6.1.2.6 6-8 sequence of steps 41 4-1 
optional screens 3.4.1 3-12 
replenish 3.4.2 3-13 Currency sign 
retain 3.5.5 3-36 automatically protected 2.4 2-5 
See also indicators. 3.5.1 3-30 
edit screen 3.4.3 3-16 
@ Conditional protection dialog editing input or 
(dialog screen 6) 3.5.6 3-37 bidirectional fields 1.3.2.3 1-11 
fixed and floating insertion 
in numeric fields 2.3.2 2-3 
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Term Reference Page Term Reference — Page 
Cursor D 
characteristics screen 3.6 3-4} 
dialog screens 3.5 3-25 DB character 
3.6 3-42 edit screen 3.4.3 3-16 
home screen 3.6 3-41 editing rules for signed output 
initial 1/0 screen 4.1.3 4-9 fields Table 2-1 2-6 
optional screens 3.6 3-42 fixed insertion in numeric fields 2.3.2 2-3 
positioning, creating a format 3.6 3-41 
positioning, filling in a format 74 7-37 Decimal point 
template screen 4.1.1 4-3 automatic alignment 2.4 2-5 
type attribute screen 4.1.2 4-7 dialog screen 1 3.5.1 3-29 
editing input or bidirectional 
fields 1.3.2.3 1-11 
fixed insertion in numeric fields 2.3.2 2-3 
protection 2.4 2-5 


Default values 





characteristics screen 41 4-3 
42.1.1 4-13 
dialog screen 2 3.5.2 3-31 
dialog screen 4 3.5.4 3-34 
dialog screens 3.5.8 3-40 
home screen 3.2.2 3-4 
4.1 4-2 
42.1.1 4-13 
5.1 5-2 
1/0 screen 4.1.3 4-8 
overwriting 3.6 3-41 
special display 3.5.4 3-34 


DELETE function 


home screen 3.2 3-1 
3.2.1 3-3 
6.2 6-13 
old format name and library 3.2.3 3-4 
use 6.1 6-1 
Device assignment set See DVC-LFD 
sequence. 


Dialog screen 1 





changing 1/0 direction of field 3.5.1 3-27 

default values 3.5.8 3-40 

3.5.1 3-30 

field requesting dialogs 3.5.1 3-26 

function 3.5.1 3-26 

Table 3-2 3-25 

internal length calculated by SFG 3.5.1 3-27 

rules 3.5.1 3-30 

sample format 4.2.1 4-1] 

42.17 4-17 

selecting other dialog screens 3.5.1 3-28 
type attributes and 1/0 direction 

of field 3.5.1 3-28 

Table 3-3 3-30 

type of internal usage 3.5.1 3-27 


warning messages on internal length 3.5.1 3-28 
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@ Term Reference Page Term Reference Page 
Dialog screen 2 default values 3.5.8 3-40 
alphabetic characters 3.5.2 3-32 dialog screen 1 3.5.1 3-26 
default values 3.5.8 3-40 dialog screen 2 3.5.2 3-31 
3.5.2 3-31 dialog screen 3 3.5.3 3-33 
display of field 3.5.2 3-31 dialog screen 4 3.5.4 3-34 
field response 3.5.2 3-31 dialog screen 5 3.5.5 3-36 
function 3.5.2 3-31 dialog screen 6 3.5.6 3-37 
Table 3-2 3-25 dialog screen 7 3.5.7 3-38 
numeric values 3.5.2 3-32 duplicate fines 44 4-25 
replenished input field 3.5.2 3-33 initiating 4.1.3 4-7 
sample format 4.2.1 4-11 LIST function 6.1.2 6-2 
4.2.1.7 4-17 range checking 3.5.7 3-38 
warning messages for line 3 3.5.2 3-32 related dialog screens Table 3-1 3-11 
42 4-10 
Dialog screen 3 related optional screens Table 3-1 3-11 
default values 3.5.8 3-40 4.2 4-10 
function 3.5.3 3-33 special display properties 3.5.4 3-34 
Table 3-2 3-25 use 3.5 3-24 
4.2 4-10 
Dialog screen 4 4.2.1.6 4-16 
conditional display properties 3.5.4 3-34 4.2.1.7 4-17 
default display properties 3.5.4 3-34 
default values 3.5.8 3-40 Direction of fields 
function 3.5.4 3-34 dialog screen 1 3.5.1 3-26 
Table 3-2 = 3-25 list screen 6.1.2.6 6-8 
& intensity/emphasis 3.5.4 3-34 RPG Il 7.3.1 7-5 
Table 3-4 3-36 variable data fields 1.3.2.2 1-9 
sample format 4.2.1 4-11 See also 1/0 directions, 1/0 fields, 
4.2.1.7 4-18 and bidirectional fields. 
Dialog screen 5 Display attributes See display 
conditional retention 3.5.8 3-36 properties. 
3.4.6 3-21 
default values 3.5.8 3-40 Display constants 
function 3.5.5 3-36 display properties 3.4.4 3-17 
Table 3-2 = 3-25 emphasis 3.4.4 3-17 
format layout 4.1.1 4-3 
Dialog screen 6 intensity 3.4.4 3-17 
conditional protection 3.5.6 3-37 part of screen format 1.3.2.1 1-9 
default values 3.5.8 3-40 protected and unprotected parts 1.3.2.3 1-11 
function 3.5.6 3-37 
Table 3-2 3-25 Display control and error message 
display 6.1.2.3 6-5 
Dialog screen 7 6.1.2 6-2 
default values 3.5.8 3-40 
function 3.5.7 3-38 Display functions 
Table 3-2 = 3-25 home screen 3.2.1 3-2 
range checking 3.5.7 3-38 LIST 3.2.1 3-3 
3.2.3 3-4 
Dialogs 6.1.2 6-1 
changing field characteristics 5.1 5-1 SHOW 3.2.1 3-3 
characteristics screen selections Table 3-1 3-11 3.2.3 3-4 
conditional display 3.5.3 3-33 6.1.1 6-1 
@ conditional indicators 3.4.1 3-12 SPOOL 3.2.1 3-3 
3.5 3-24 3.2.3 3-4 
conditional protection 3.5.6 3-37 6.1.3 6-13 
conditional retention 3.5.5 3-36 use 3.2.1 3-2 
6.1 6-1 
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Term Reference Page Term Reference Page 
Display properties DMSEL,SCREEN (select a screen format) 
alternate Appendix E BAL imperative macroinstruction 7.3.4 7-27 
conditional 3.5.4 3-34 7.3.4.4 7-31 
default 3.5.4 3-34 CD$DDINF+11 error conditions 
dialog screen 4 3.5.4 3-34 returned 7.3.44 7-32 
display constants 3.4.4 3-18 
display control and error message Duplicate lines 44 4-24 
display 6.1.2.3 6-5 
error message screen 3.4.5 3.20 DVC-LFD sequence 
fields 3.4.4 3-17 COBOL 7.3.2 7-10 
fields in error 3.4.4 3-18 examples Al A-3 
input fields 3.4.4 3-17 job control 7.2 7-1 
output fields 3.4.4 3-17 
selections Table 3-4 = 3-36 
special display properties dialog 3.5.4 3-34 
special display screen 3.4.4 3-17 


Display retention 


characteristics screen 3.3 3-5 
3.3.9 3-10 
display retention screen 3.4.6 3-21 


Display retention screen 


characteristics screen 3.3 3-5 

3.3.9 3-10 
field display attributes 3.4.6 3-21 

3.5.4 3-34 
field level display retention 3.4.6 3-21 

3.5.5 3-36 
use 3.4 3-11 

3.4.6 3-21 

DMINP (retrieve a record) 

BAL imperative macroinstruction 7.3.4 7-27 

7.3.4.3 7-29 
CD$DDINF+11 error codes returned 7.3.4.3 7-30 
DMOUT 7.3.4.3 7-29 
DMSEL 7.3.4.3 7-29 
function keys 7.3.4.3 7-29 
input record size 7.3.4.3 7-29 
response indicators 7.3.4.3 7-29 
variable-length records 7.3.4.3 7-30 
work area 7.3.4.3 7-29 

DMOUT (output a record) 

BAL imperative macroinstruction 7.3.4 7-27 

7.3.4.5 7-33 
CD$DDINF +11 error codes 7.3.45 7-34 


error conditions returned 73.45 7-33 
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E Erase indicator 3.4.2 3.13 
Edit characters Erasing option 
edit screen 3.4.3 3-16 characteristics screen 3.3 3-5 
variable data fields 4.1.2 4-5 3.3.4 3-7 
~ AQ A-7 
Edit mask conditional erase/replenish screen 3.4.2 3-15 
dialog screen 1 3.5.1 3-26 4.2.1 4-10 
editing input or bidirectional 
fields 1.3.2.3 1-11 Error message display 6.1.2.3 6-5 
editing numeric fields 2.4 2-4 
Error message field, characteristics 
Edit screen screen 3.3 3-5 
rules for completion 3.4.3 3-16 3.3.8 3-10 
special editing characters 
(characteristics screen) 3.3.6 3-9 Error message screen 
3.4.3 3-16 characteristics screen 3.4.5 -18 
special editing display 6.1.2.2 6-4 3.3.8 -10 
use 3.4 3-11 display control and error message 
3.4.3 3-16 display 6.1.2.3 6-5 
yen sign for Katakana 3.4.3 3-16 emphasis 3.4.5 3-20 
intensity 3.4.5 3-20 
Editing sample format 42.1 4-10 
alphabetic and alphanumeric fields 2.3.1 2-2 4.2.1.3 4-14 
edit screen 3.4.3 3-16 use 3.4 3-11 
examples Table 2-2 2-7 3.4.5 3-18 
@ insertion 2.3.1 2-2 
numeric fields 2.3.2 2-3 Error retry counts, characteristics 
results 2.4 2-4 screen 3.3 3-5 
rules for signed output fields Table 2-1 2-6 3.3.5 3-8 
special characters 3.3.6 3-9 
supression/replacement 2.3.2 2-4 Errors 
variable data fields 4.1.2 4-5 dialog screen 1] 3.5.1 3-28 
dialog screen 2 3.5.2 3-33 
Editing characters dialog screen 7 3.5.7 3-39 
initiating dialogs 4.13 4-8 duplicate tines 44 4-25 
input or bidirectional fields 1.3.2.3 1-11 error message display 6.1.2.3 6-5 
special 3.3.6 3-9 fields in 3.4.4 3-7 
3.4.3 3-16 function key 3.4.7 3-23 
indicated on workstation 1.3.1 1-7 
Emphasis initial 1/0 screen 4.1.3 4-8 
alternate display properties Appendix E messages (home screen) 3.7 3-43 
device support Appendix E rules for dialog screens 3.5 3-25 
dialog screen 4 3.5.4 3-34 type attribute screen 4.12 4-7 
display constants 3.4.4 3-18 type of data 14 1-13 
display property 3.4.4 3-17 
Table 3-4 = 3-36 ESCORT 7.3.5 7-34 
error message screen 3.4.5 3-20 
fields in error 3.4.4 3-18 Exclamation point 
input fields 3.4.4 3-17 dialog screen 1 3.5.1 3-28 
output fields 3.4.4 3-17 editing alphabetic and 
selections Table 3-4 =. 3-36 alphanumeric. fields 2.3.1 2-2 
special display properties 3.5.4 3-34 editing numeric fields 2.3.2 2-3 
special display screen 3.4.4 3-17 initiating dialogs 4.1.3 4-8 
& 3.5.4 3-55 results of editing 2.4 2-4 
type attribute screen 4.1.2 4-6 
English, default alphabet 3.3.2 3-6 
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Term Reference Page Term Reference Page 
External field length Floating insertion, editing numeric 
defined 2.3.1 2-3 fields 2.3.2 2-4 
editing examples Table 2-2 2-7 
0 and B counted 2.3.1 2-2 Format See screen 
screen layout 41.1 4-3 formats. 
Format display 6.1.2.5 6-6 
Format names 
FSTATUS command 3.2.3 3-5 
home screen 3.2 3-2 
list screen 6.1.2.6 6-6 
new 3.2.2 3-4 
old 3.2.3 3-4 
summary screen 6.1.2.1 6-3 
FORTRAN 
Program using screen formats 7.3.3 7-26 
USE SFS statement Al A-2 
FSTATUS command, existing format names 3:23 3-5 
Function/command key display 6.1.2.4 6-5 
6.1.2 6-2 
Function/command key screen 
characteristics screen 3.3.10 3-10 
function/command key display 6.1.2.4 6-5 
function keys Appendix C 
use 3.4 3-11 
3.4.7 3-22 
F 
Function keys 
Field 1/0 directions See 1/0 directions BAL 73.4.3 7-29 
and direction characteristics screen 3.3 3-5 
of fields. 3.3.10 3-10 
COBOL 7.3.2.3 7-21 
Field response dialog screens 3.5 3-25 
dialog screen 2 3.5.2 3-31 function/command key display 6.1.2.4 6-5 
sublist screen 6.1.2.7 6-9 function/command key screen 3.4.7 3-22 
home screen 3.2 3-2 
Field type attributes use Appendix C 
CREATE-FROM and MODIFY functions 5.1 5-1 
defined 2.1 2-1 
modify screen 5.1.1.2 5-3 
rules 2.2 2-1 
specifying 4.1.2 4-5 
File specifications form (RPG II) 73.1 7-5 
Fixed insertion, editing numeric fields 2.3.2 2-3 


Flag, conditional indicator 3.4.1 3-12 
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Term 


HELP function 
dialog screens 
prompting by SFG 
requesting 
screens 


Help screens 


Home screen 
CREATE-FROM function 


CREATE function 


cursor positioning and overwriting 
DELETE function 


display functions 
functions provided by SFG 
LIST function 


MODIFY function 


new format name and library 
old format name and library 
sample format 
SHOW function 


SPOOL function 


TERMINATE function 


Reference 


3.5 

1.3.1 

3.8 
Appendix B 


Appendix B 


3.2.1 
3.2.2 
5.1 
5.2 
3.2.1 
3.2.2 
3.3.3 
41 
3.6 
3.2.1 
3.2.3 
6.2 
6.1 
3.2.1 
3.2.1 
3.2.3 
6.1.2 
3.2.1 
3.2.3 
5.1 
3.2.2 
3.2.3 
4.2.1.1 
3.2.1 
3.2.3 
6.1.1 
3.2.1 
3.2.3 
6.1.3 
3.2.1 
6.2 
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Page Term 


I 

| - for input, initial 1/0 screen 
3-25 
1-7 Imperative macroinstructions, BAL 
3-44 

IMS programming considerations 

Indicators 

BAL 
COBOL 

3-3 conditional 
3-4 
5-1 display retention 
5-6 erase 
3-2 option 
3-4 
3-6 protection 
4-] replenish 
3-41 response 
3-3 
3-4 
6-13 retain 
6-1 
3-2 
3-3 RPG Il 
3-4 special display properties 
6-1 syntax 
3-3 
3-4 
5-1 
3-4 
3-4 
4-12 Initial 1/0 screen 
3-3 
3-4 Input data 
6-1 transfer by screen format 
3-3 coordinator 
3-4 variable data fields 
6-13 
3-3 Input fields 
6-13 


Input format specifications form 
(RPG Il) 


Input record screen 


Insertion editing 
alphabetic and alphanumeric fields 
dialog screen 1 


numeric fields 


Index 9 


Reference Page 


4.13 4-7 
See BAL. 

7.3.6 7-35 
7.3.4.3 7-29 
7.3.2.2 7-18 
See conditional 
indicators. 

3.4.6 3-21 
3.4.2 3-15 
3.4.7 3-22 
7.3.2.2 7-18 
3.5.6 3-37 
3.4.2 3-13 
3.4.7 3-22 
7.3.2.2 7-18 
7.3.4.3 7-29 
3.5.3 3-34 
3.5.5 3-37 
3.5.6 3-38 
3.4.7 3-23 
3.5.4 3-35 
3.4.1 3-12 
3.5.3 3-33 
3.5.4 3-35 
3.5.5 3-37 
3.5.6 3-37 
4.1.3 4-7 
1.2 1-4 
1.3.2.2 1-9 
See 1/0 fields. 
7.3.1 7-5 
Fig. 7-1 7-7 
7.3.6 7-35 
6.1.2 6-2 
6.1.2.9 6-12 


2.3.1 2-2 
Table 3-2 3-2 
3.5.1 3-2 
2.3.2 2-3 
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Term Reference Page Term Reference Page 
Intensity emphasis 3.4.4 3-17 
alternate display properties Appendix E 3.4.6 3-21 
device support Appendix E ESCORT 7.3.5 7-34 
dialog screen 4 3.5.4 3-34 field resonse 3.5.2 3-31 
display constants 3.4.4 3-18 FORTRAN 7.3.3 7-26a 
display property 3.4.4 3-17 function/command key screen 3.4.7 3-22 
Table 3-4 = 3-36 IMS 7.3.6 7-35 
error message screen 3.4.5 3-20 initial 1/0 screen 4.1.3 4-7 
fields in error 3.4.4 3-18 intensity 3.4.4 3-17 
input fields 3.4.4 3-17 3.4.6 3-21 
output fields 3.4.4 3-17 LIST function 6.1.2 6-1 
selections Table 3-4 =. 3-36 list screen 6.1.2.6 6-7 
special display properties 3.5.4 3-34 nondisplay screen 3.4.8 3-23 
special display screen 3.4.4 3-17 protected and unprotected parts 1.3.2.3 1-11 
range checking 3.5.7 3-38 
Internal field length replenishing value 3.5.2 3-31 
defined 2.3.1 2-3 RPG Il 7.3.1 7-5 
dialog screen 1 Table 3-2 3-25 SHOW function 6.1.1 6-1 
3.5.1 3-26 special display properties 3.5.4 3-35 
editing examples Table 2-2 2-7 specifying directions 4.1.3 4-7 
0 and B not counted 2.3.1 2-2 specifying type attributes and 
results of editing 2.4 2-4 editing 4.1.2 4-5 
type attributes 2.1 2-1 
1/0 directions 2.2 2-2 
bidirectional 4.13 4-7 See also variable data fields. 
dialog screen 1 _ 3.5 3-26 
3.5.1 3-26 1/0 screen display 4.13 4-7 
duplicate tines 44 4-24 
initial 1/0 screen 4.13 4-7 
input 4.1.3 4-7 
modify screen 5.1.1 5-2 
output 4.1.3 4-7 
See also bidirectional fields, 1/0 
fields, and variable data fields. J 
1/0 fields Job control 
bidirectional See multiple workstations A.2 A-6 
bidirectional statements 7.2 7-1 
fields. USE SFS statement Al A-1 
classifications 1.3.2.2 1-9 
COBOL 7.3.2.1 7-10 
conditional display 3.5.3 3-33 
conditional erase/replenish screen 3.4.2 3-14 
conditional protection 3.5.6 3-37 
conditional retention 3.5.5 3-36 
default value 3.5.2 3-31 
dialog screen 1 3.5 3-24 
3.5.1 3-26 K 
dialog screen 2 3.5.2 3-31 
dialog screen 3 3.5.3 3-33 Katakana 
dialog screen 6 3.5.6 3-37 default currency sign 3.4.3 3-16 
dialog screen 7 3.5.7 3-38 no lowercase translation 3.3.1 3-6 
display properties 3.4.4 3-17 All 4-5 
display retention screen 3.4.6 3-21 
editing characters 1.3.2.3 1-11 Keys, function See 
editing rules for signed output function 
fields Table 2-1 2-6 keys. 
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& Term 


Language, characteristics screen 


Library file (user-assigned) 
DVC/LFD sequence 


modifying formats 


LIST function 
conditional values screen 
display control and error message 
display 
format display 
function/command key display 
home screen 


input record screen 

list screen 

old format name and library 
output record screen 

special editing display 
sublist screen 

summary screen 


& use 


List screen 


Lowercase translation 
characteristics screen 


range checking 


Low-intensity display 
protected and unprotected parts of 
screen format 
special display screen 





Reference 


7.2 


5.1 


6.1.2.8 


6.1.2.3 
6.1.2.5 
6.1.2.4 


3.2.1 
3.2.3 
6.1.2.9 
6.1.2.6 
3.2.3 
6.1.2.10 
6.1.2.2 
6.1.2.7 
6.1.2.1 
3.2.1 


6.1.2 


6.1.2 
6.1.2.6 
6.1.2.7 


3.3 
3.3.1 
3.5.7 


1.3.2.3 
3.4.4 
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Page Term 
M 

3-6 Minus sign 

editing rules for signed output 

fields 

7-1 fixed and floating insertion in 
A-3 numeric fields 
5-1 


MIRAM user library, storing formats 


6-11 MODIFY function 
characteristics screen 


6-5 dialog screen 1 

6-6 formats 

6-5 

3-1 

3-3 

3-4 home screen 

6-12 

6-6 

3-4 language 

6-12 modify screen 

6-4 old format name and library 

6-9 original and overlay formats 

6-3 summary 

3-3 

6-1 Modify screen 

6-1 completing 
dialog screen 1 

6-2 modification summary 

6-6 option 1 (CHANGE TEMPLATE) 

6-9 option 2 (CHANGE TYPE) 
option 3 (CHANGE 1/0) 
option 7 (CHANGE TEMPLATE ONLY - 

3-5 NO INTERNAL CHANGES) 

3-6 

3-39 

-ll 

-17 


Index 11 


Reference 


Table 2-1 


2.3.2 


12 


5.1.1 
3.5.1 
5.2 
5.1.1.1 
5.1.1.2 
5.1.1.3 


5.1.1.4 


Page 
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Term Reference Page Term Reference Page 
N O 
New format name and library, 0 - for output, 1/0 screen 4.13 4-8 
home screen 3.2 3-2 
3.2.2 3-4 Old format name and library, 
home screen 3.2 3-2 
Nondisplay screen 3.2.3 3-4 
characteristics screen 3.3.11 3-11 
use 3.4 3-11 OPEN (open a file), BAL imperative 
3.4.8 3-23 macroinstruction 7.3.4.1 7-27 
Nondisplayed field Option indicators 
characteristics screen 3.3 3-5 COBOL 7.3.2.2 7-18 
3.3.11 3-11 function/command key screen 3.4.7 3-22 
nondisplay screen 3.4.8 3-23 
Optional screens 
Numeric fields characteristics screen Table 3-1 3-11 
default values for dialog screens 3.5.8 3-40 conditional erase/replenish screen 3.4.2 3-13 
editing 2.3.2 2-3 conditional indicators 3.4.1 3-12 
range checking 3.5.7 3-38 dialog screens Table 3-1 = 3-11 
rules 2.2 2-1 display retention screen 3.4.6 3-21 
type attributes 4.1.2 4-5 edit screen 3.4.3 3-16 
variable data fields 1.3.2.2 1-9 error message screen 3.4.5 3-18 
function/command key screen 3.4.7 3-22 
9 character nondisplay screen 3.4.8 3-23 
indicating alphanumeric fields 2.2 2-2 special display screen 3.4.4 3-17 
indicating numeric fields 2.2 2-2 use 3.4 3-11 
Original format, characteristics screen 3.3 3-5 
3.3.3 3-6 
41 4-2 
Output data, transfer by SFC 1.2 1-4 
Output fields See 1/0 
fields. 
Output format specifications form 
(RPG Il) 7.3.1 7-6 
Fig. 7-1 7-8 
7.3.6 7-36 
Output record screen 6.1.2 6-2 
6.1.2.10 6-12 
Overlay formats 
advantage 4.3.1 4-20a 
characteristics screen 3.3.3 3-6 
creation 4.3.2 4-22 
SOE character 4.3.2 4-23 
use 43 4-20a 
43.1 4-20a 
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e@ Term Reference Page Term Reference Page 
Overwriting R 
completing SFG screens 3.6 3-41 
dialog screen 1 3.5.1 3-27 Range checking 
dialog screen 2 3.5.2 3-31 default values 3.5.8 3-40 
dialog screen 4 3.5.4 3-35 dialog screen 1 3.5.1 3-28 
dialog screen 7 3.5.7 3-38 dialog screen 7 3.5.7 3-38 
edit screen 3.4.3 3-16 list screen 6.1.2.6 6-8 
initiating dialogs 4.1.3 4-8 sublist screen 6.1.2.7 6-9 
1/0 screen 4.13 4-8 
modifying formats 5.1.1 5-2 Replenish indicator, conditional/ 
erase replenish screen 3.4.2 3-13 
Replenishing value 
conditional erase/replenish screen 3.4.2 3-13 
default values 3.5.8 3-40 
dialog screen 2 3.5.2 3-31 
edit screen 3.4.3 3-16 
list screen 6.1.2.6 6-8 
sublist screen 6.1.2.7 6-9 
Response indicators 
BAL 7.3.4.3 7-29 
COBOL 7.3.2.2 7-18 
function/command key screen 3.4.7 = 
P RPG 3.4.7 3-23 
Passes RPG Il : Lak 
dialog screens 35 3-24 file specifications form 7.3.1 7-5 
413 4-7 input format specifications form 7.3.1 7-5 
421 4-11 output specifications form 7.3.1 7-6 
display constants 13.21 1-9 response indicators 3.4.7 3-23 
optional screens 4.2 4-10 screen formats 73.1 ed 
421.2 4-13 Ls 
4213 4-14 USE SFS statement Al A-2 
eS eer ere tela ai | RV SFGEN command, activating the SEG 3.1 3-1 
pass 2 - specifying type attributes 
and editing 4.1.2 -5 
4.2.1.5 4-15 
pass 3 - specifying 1/0 directions 
and initiating dialogs 4.1.3 4-7 
4.2.1.6 4-16 
review 4.1.3 4-9 
specifying field type 14 1-13 
variable data fields 1.3.2.2 1-9 
Plus sign 
editing rules for signed output 
fields Table 2-1 2-6 
fixed and floating insertion in 
numeric fields 2.3.2 2-3 


Protected fields 
& description 1.3.2.3 1-11 
SHOW function 6.1.1 6-1 
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Term Reference Page Term Reference Page 
S duplicate lines 44 4-24 
edit screen 3.4.3 3-16 
Screen format coordinator erasing option See erasing 
BAL 7.3.4.5 7-33 option. 
COBOL 7.3.2.2 7-18 error and warning messages 3.7 3-43 
conditional erase/replenish screen 3.4.2 3-14 error message field 3.3.8 3-10 
conditional indicators 3.4.1 3-12 error message screen 3.4.5 3-18 
dialog screen 2 3.5.2 3-31 error retry counts 3.3.5 3-8 
dialog screen 5 3.5.5 3-37 format display 6.1.2.5 6-6 
dialog screen 7 3.5.7 3-39 function 1.2 1-4 
display retention 3.3.9 3-10 Fig. 1-4 1-5 
display retention screen 3.4.6 3-21 13 1-6 
edit screen 3.4.3 3-17 3.2.1 3-2 
error message screen 3.4.5 3-19 5.1 5-1 
FORTRAN 7.3.3 7-26 6.1 6-1 
function 1.2 1-4 6.2 6-13 
Fig. 1-4 1-5 function/command key display 6.1.2.4 6-5 
14 1-13 function/command key screen 3.4.7 3-22 
function/command key screen 3.4.7 3-22 function keys 3.3.10 3-10 
job control 7.2 7-1 HELP function 3.8 3-44 
option indicators 3.4.7 3-22 help screens Appendix B 
program considerations 7.3 7-5 home screen 3.2 3-1 
programmer responsibilities 71 7-1 initiating dialogs 4.13 4-] 
range checking 3.5.7 3-39 input record screen 6.1.2.9 6-12 
REPLENISH SCREEN option 3.3.4 3-7 LIST function See LIST 
response indicators 3.4.7 3-22 function. 
RPG Il 7.3.1 7-5 list. screen 6.1.2.6 6-6 
software element of screen lowercase translation 3.3.1 3-6 
format services 1.2 1-4 MODIFY function See MODIFY 
UNLOCK KEYBOARD option 3.3.4 3-8 function. 
workstation considerations 7.3.2.4 7-26 modifying formats 51 5-1 
7.4 7-37 5.2 5-6 
new format name and library 3.2.2 3-4 
Screen format generator nondisplay screen 3.4.8 3-23 
activating 3.1 3-] nondisplayed field 3.3.11 3-11 
alphabet 3.3.2 3-6 old format name and library 3.2.3 3-4 
basic screen formats 41 4-] optional screens 3.4 3-11 
characteristics screen 3.3 3-5 42 4-10 
complex screen formats 4.2 4-10 original formats 3.3.3 3-6 
conditional erase/replenish screen 3.4.2 3-13 4] 4-2 
conditional indicators 3.4.1 3-12 output record screen 6.1.2.10 6-12 
conditional values screen 6.1.2.8 6-11 overlay formats 3.3.3 3-6 
CREATE-FROM function See CREATE-FROM 4.3.2 4-22 
function. 43.1 4-20a 
CREATE function See CREATE passes See passes. 
function. prompting 1.3.1 1-7 
cursor positioning and overwriting 3.6 3-41 sample format 4.2.1 4-10 
default values for dialog screens 3.5.8 3-40 SHOW function See SHOW 
DELETE function See DELETE function. 
function. software element of screen format 
dialog screens 3.5 3-24 services 1.2 1-4 
42 4-10 special display control 3.3.7 3-9 
display control and error message special display screen 344 3-17 
display 6.1.2.3 6-5 special editing characters 3.3.6 3-9 
display functions See display special editing display 6.1.2.2 6-4 
functions. SPOOL function See SPOOL 
display retention 3.3.9 3-10 function. 


display retention screen 3.4.6 3-21 
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@ Term Reference Page Term Reference Page 
Screen format generator (cont) overlay 3.3.3 3-6 
sublist screen 6.1.2.7 6-9 43 4-20a 
summary screen 6.1.2.1 6-3 program considerations 7.3 7-5 
TERMINATE function See TERMINATE program use 71 7-1 
function. programmer responsibilities 71 7-1 
unlocking option 3.3.4 3-7 prompting 1.3.1 1-7 
3.4.2 3-15 protected and unprotected parts 1.3.2.3 1-11 
41 4-3 RPG Il 7.3.1 7-5 
4.2.1.1 4-13 sample 42.1 4-10 
SYSRES volume 1.2 1-4 
Screen format services system library ($Y$FMT) 1.2 1-4 
format creation 1.2 1-1 template screen Fig. 4-1 4-3 
format use 1.2 1-1 type attribute screen Fig. 4-2 4-6 
interactive component of OS/3 1.2 1-1 type attributes and editing 412 4-5 
screen format coordinator (SFG) See screen variable data fields 1.3.2.2 1-9 
format coordinator. 
screen format generator (SFG) See screen SFC See screen 
format generator. format 
software elements 1.2 1-4 coordinator. 
Screen formats SFG See screen 
BAL 7.3.4 7-27 format 
basic 4. 4-1 generator. 
characteristics screen See characteristics 
screen. SFS See screen 
@ COBOL 73.2 7-9 format 
complex 4.2 4-10 services. 
components 1.3.2 7-9 
creating 1.3.1 1-7 SHOW function 
cursor positioning and overwriting 3.6 3-41 home screen 3.2 3-1 
deleting 1.3.1 1-7 3.2.1 3-3 
6.2 6-13 old format name and library 3.2.3 3-4 
3.2.1 3-3 use 3.2.1 3-3 
3.2.3 3-4 6.1 6-1 
dialogs 3.5 3-24 6.1.1 6-1 
display constants 1.3.2.1 1-9 
displaying 1.2 1-1 Signed output fields, editing rules Table 2-1 2-6 
1.3.1 1-7 
6.1 6-7 Simple insertion, editing numeric 
duplicate lines 44 4-24 fields 2.3.2 2-3 
error and warning messages 3.7 3-43 
error indication 1.3.1 1-7 Slash, dialog screen 1 3.5.1 3-30 
ESCORT 73.5 7-34 
FORTRAN 7.3.3 7-26 SOE character, overlay format 4.3.2 4-23 
home screen See home 
: screen. Special display control 
input 1.2 1-1 characteristics screen 3.3 3-5 
job control 7.2 7-1 3.3.7 3-9 
layout 1.2 1-4 special display screen 3.4.4 3-17 
4.1.1 4-3 
MIRAM user library 1.2 1-4 Special display screen 
modifying 1.3.1 1-7 display control and error 
3.2.1 3-3 message display 6.1.2.3 6-5 
& 5.1 5-1 display properties 3.4.4 3-17 
% original 3.3.3 3-6 Appendix £ 
4) 4-1 use 3.4 3-11 
output 1.2 1-1 3.4.4 3-17 
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Special editing characters T 
characteristics screen 3.3 3-1 
3.3.6 3-9 Template screen 
edit screen 3.4.3 3-16 duplicate lines 44 4-24 
type attribute screen 4.1.2 4-7 overlay format 4.3.2 4-22 
pass 1 41.1 4-3 
Special editing display 6.1.2.2 6-4 4.2.1.4 4-14 
6.1.2 6-2 pass 2 4.1.2 4-5 
4.2.1.5 4-15 
SPOOL function pass 3 4.1.3 4-7] 
home screen 3.2 3-1 4.2.1.6 4-16 
3.2.1 3-3 typical Fig. 4-1 4-3 
old format name and library 3.2.3 3-4 
use 3.2.1 3-3 TERMINATE function 
6.1 6-1 home screen 3.2 3-1 
6.1.3 6-13 3.2.1 3-3 
use 3.2.1 3-3 
Start of entry character, overlay format 4.3.2 4-23 6.1 6-1 
6.2 6-13 
Sublist screen 6.1.2 6-2 
6.1.2.7 6-9 Type attribute screen 4.1.2 4-5 
Summary screen 6.1.2.1 6-3 Type attributes 
defined 2.1 2-1 
Suppression/replacement editing 2.3.2 2-3 duplicate lines 44 4-24 
format display 6.1.2.5 6-6 
Syntax, indicator LIST function 6.1.2 6-2 
conditional 3.4.1 3-12 rules 2.1 2-1 
dialog screen 3 3.5.3 3-33 SHOW function 6.1.1 6-1 
dialog screen 4 3.5.4 3-35 Specifying 4.1.2 4-5 
dialog screen 5 3.5.5 3-37 typical screen Fig. 4-2 4-6 
dialog screen 6 3.5.6 3-37 
SYSRES volume, storing formats 1.2 1-4 
System library ($Y$FMT) 
home screen 3.2.2 3-4 
Storing formats 1.2 1-4 
U 
Underlines 
dialog screen 2 3.5.2 3-31 
edit screen 3.4.3 3-16 
format layout 4.1 4-4 
initiating dialogs 4.13 4-8 
input fields 1.3.2.2 1-9 
2.4 2-5 
result of editing 24 2-4 
type attribute screen 4.1.2 4-6 
variable data fields 1.3.2.2 1-9 
4.2.1.4 4-14 
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@ Term Reference Page Term Reference Page 
Unlocking option W 
characteristics screen 3.3 3-5 
3.3.4 3-7 Warning messages 3.7 3-43 
conditional erase/replenish screen 3.4.2 3-15 
creating basic format 41 4-3 Workstation considerations 
creating complex format 4.2.1.1 4-13 interprogram communication 7.3.2.4 7-26 
operator 74 7-37 
Unprotected fields 
description 1.3.2.3 1-11 
SHOW function 6.1.1 6-1 
Uppercase alphabetical characters, 
translation 3.3.1 3-6 
USE SFS job control statement 7.2 7-1 X 
Al A-1 
X character, indicating 
alphanumeric fields 2.2 2-2 
V 
Y 
Variable data fields 
considerations 2.1 riae Yen sign, default currency sign 
dialog screens 3.9 3-24 for Katakana 3.4.3 3-16 
3.5.1 3-27 
display retention screen 3.4.6 3-21 
duplicate lines 44 4-24 
edit characters 4.1.2 4-3 
IMS 7.3.6 7-36 
\/0 direction 4.2.1.6 4-16 
layout 1.3.2.2 1-9 
4.2.1.4 4-14 
pass 1 4.1.1 4-3 
4.2.1.4 4-14 
pass 2 4.1.2 4-5 
4215 4-15 
pass 3 4.13 4-7 Zz 
oe re Z character, suppression/replacement 
protected and unprotected parts 1.3.2.3 1-11 editing in sianieries Welds 232 2-3 
RPG Il 73.1 7-5 re 
fype= attributes re ae Zero character 
4215 15 editing alphabetic and 


eco ; alphanumeric fields 2.3.2 
@ = cue fields and insertion in numeric fields 2.3.2 
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